JiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.
Python
# Copy to project root .env and adjust as needed
# 独立 jiuwenswarm:普通单 Agent 对话默认使用 Flash,无需客户端发送 mode=flash。
# 设置时优先于 config.yaml 的 flash.enabled;不设置则回退 config(默认 false)。
# 必须注入实际运行 Agent 的 AgentServer 进程;修改后重启服务。
# 企业版不加载 .env,请通过容器/服务的进程环境注入。
# OfficeClaw/PC 前台仍走显式模式;Code、Team、Plan 与已有会话绑定保持原规则。
# 仅切换默认 Agent 实现,不开启技能检索。
# config.yaml: enabled: ${JIUWENSWARM_FLASH_ENABLED:-false}
# JIUWENSWARM_FLASH_ENABLED=true
# Flash 技能检索独立开关,不负责选择 Agent 实现。
# 设置 true/false 均覆盖 flash.skill_selection.enabled;未设置时回退 config(默认 false)。
# 只覆盖运行时生效值,不改写 config 文件;同样须注入 AgentServer 进程并重启。
# config.yaml: skill_selection.enabled: ${JIUWENSWARM_FLASH_SKILL_SELECTION_ENABLED:-false}
# JIUWENSWARM_FLASH_SKILL_SELECTION_ENABLED=false
# Flash 技能自演进独立开关,不继承 react.evolution 全局开关。
# 设置 true/false 覆盖 flash.evolution.enabled;未设置默认 false(在线演进不开启)。
# config.yaml: evolution.enabled: ${JIUWENSWARM_FLASH_EVOLUTION_ENABLED:-false}
# JIUWENSWARM_FLASH_EVOLUTION_ENABLED=false
# Flash SkillSleep 独立开关;rail 常驻,训练是否执行仍看技能级 selfEvolution。
# 设置 true/false 覆盖 flash.evolution.skill_sleep.enabled;未设置默认 true。
# config.yaml: evolution.skill_sleep.enabled: ${JIUWENSWARM_FLASH_SKILL_SLEEP_ENABLED:-true}
# JIUWENSWARM_FLASH_SKILL_SLEEP_ENABLED=true
# Enterprise Claw Manager / Gateway manager_ws_client examples
# =============================================================================
# MANAGER CONFIGURATION
# =============================================================================
# Manager REST API
MANAGER_REST_HOST=0.0.0.0
MANAGER_REST_PORT=8765
# Manager WebSocket Server
MANAGER_WS_ENABLED=true
MANAGER_WS_HOST=0.0.0.0
MANAGER_WS_PORT=8766
# Gateway WS heartbeat: mark instance offline if no heartbeat within timeout (seconds)
MANAGER_HEARTBEAT_TIMEOUT_SECONDS=120
# How often Manager scans for stale heartbeats (seconds)
MANAGER_HEARTBEAT_SCAN_INTERVAL_SECONDS=60
# Manager database: sqlite | mysql
MANAGER_DB_TYPE=sqlite
MANAGER_SQLITE_PATH=manager.db
MANAGER_DB_HOST=127.0.0.1
MANAGER_DB_PORT=3306
MANAGER_DB_USER=root
MANAGER_DB_PASSWORD=root
MANAGER_DB_NAME=manager
# Optional: allow local provision
MANAGER_ALLOW_LOCAL_PROVISION=true
# =============================================================================
# GATEWAY CONFIGURATION
# =============================================================================
# Gateway database: sqlite | mysql
GATEWAY_DB_TYPE=sqlite
GATEWAY_SQLITE_PATH=gateway.db
GATEWAY_DB_HOST=127.0.0.1
GATEWAY_DB_PORT=3306
GATEWAY_DB_USER=root
GATEWAY_DB_PASSWORD=root
GATEWAY_DB_NAME=gateway
# Web database: sqlite | mysql(当前用于会话历史;sqlite 路径可复用给 Web 其它本地库)
# Enterprise (active-standby / distributed) should use mysql + WEB_DB_HOST
WEB_DB_TYPE=sqlite
WEB_SQLITE_PATH=web.db
WEB_DB_HOST=127.0.0.1
WEB_DB_PORT=3306
WEB_DB_USER=root
WEB_DB_PASSWORD=root
WEB_DB_NAME=web
# Gateway / AgentServer 访问 MySQL、PostgreSQL 时的 SQLAlchemy 连接池参数(企业 checkpoint 复用)
# 单池峰值连接数 ≈ GATEWAY_DB_POOL_SIZE + GATEWAY_DB_MAX_OVERFLOW
GATEWAY_DB_POOL_SIZE=2
GATEWAY_DB_MAX_OVERFLOW=20
GATEWAY_DB_POOL_TIMEOUT=30
# Enterprise checkpointer: sqlite | mysql | postgresql (mysql/postgresql use GATEWAY_DB_*)
CHECKPOINT_DB_TYPE=sqlite
# Optional: override log directory (e.g. container-local path instead of NFS workspace)
# LOG_ROOT_PATH=/var/log/jiuwenswarm
# --- Manager Config Receiver(Gateway 承接 Manager 配置下发的 HTTP 服务)---
# 是否启用 Config Receiver;false 时不监听,Manager 无法经 HTTP 同步配置
GATEWAY_CONFIG_RECEIVER_ENABLED=true
# Config Receiver 监听地址(容器内一般保持 0.0.0.0)
GATEWAY_CONFIG_HTTP_HOST=0.0.0.0
# Config Receiver 监听端口(与 Service config-http 一致,默认 8775)
GATEWAY_CONFIG_HTTP_PORT=8775
# Gateway 对外主机名,供 Manager 下发配置时回调(端口同上 HTTP_PORT)
GATEWAY_CONFIG_PUBLIC_HOST=127.0.0.1
# Gateway 注册调用的 Manager 服务地址(无尾斜杠;可选)
GATEWAY_MANAGER_HTTP_URL=http://127.0.0.1:8765
# Gateway 日志脱敏开关(true/false,默认 true;读仓库根 .env 或容器注入的环境变量)
LOG_MASK_ENABLED=true
# 设为 false 时仅输出控制台日志,不写本地文件(fluent-bit/vector 采集 stdout 时使用)
# LOG_TO_FILE_ENABLED=true
# Instance id used for enterprise config isolation (set by Manager WS register.ack)
# JIUWENCLAW_ID=
# --- Workspace quota(写盘门禁 / 用量条 / 扩容 / 工作空间页)---
# 用户空间配额特性开关。默认关闭。与 Manager 共用同名变量。
WORKSPACE_QUOTA_ENABLED=false
# 无命中策略时的默认上限(个人版常用)。单位:字节;未设置默认 10 TiB;0 / 负数 / 非法值回落默认。改后需重启生效。
# 示例 50 GiB:
# AGENT_WORKSPACE_QUOTA_DEFAULT_LIMIT_BYTES=53687091200
# ====================== 统一工具开关(黑名单)======================
# 禁用的工具列表(逗号或分号分隔),config.yaml 中通过 disabled_tools: ${DISABLED_TOOLS-...} 引用
# 列出的工具名将在 agent init 后从注册表注销,模型不可见;未列出者默认注册。
# 示例:DISABLED_TOOLS=bash,write_file,fork_agent
# 默认禁用 search_skill / install_skill / uninstall_skill(技能广场界面安装不受影响,
# 那条链路走 SkillManager.handle_skills_install,不经模型工具)。
# 留空 = 全部启用;覆盖默认三工具可填:DISABLED_TOOLS=
DISABLED_TOOLS=search_skill,install_skill,uninstall_skill
# Personal A2A: allow loopback addresses and plaintext HTTP independently.
# Loopback HTTP requires both; public HTTP requires ALLOW_HTTP. Private networks stay blocked.
A2A_OUTBOUND_ALLOW_LOOPBACK=false
A2A_OUTBOUND_ALLOW_HTTP=false