跳转到内容

托管与外部模式

外部模式 External 托管模式 Managed HTTP + 令牌 负责启停管理 OpenClaw Gateway wx serve (用户自管) OpenClaw Gateway wx serve (子进程)
特性对比外部模式 (External)托管模式 (Managed)
谁来运行 wx serve用户自管:wx daemon、systemd 或 DockerOpenClaw 作为子进程负责启停
部署位置Gateway 可访问的任意网络地址与 Gateway 位于同一台物理机
Gateway 所在机器是否需要 wx否是
Gateway 退出时Daemon 依然保持后台运行Daemon 随之停止退出
适用场景习惯在终端使用 CLI,或在 Docker 中部署 Daemon希望单进程统一管理所有组件

外部模式 (External) 是默认推荐的方式。快速上手配置 采用的即是外部模式。

托管模式 (Managed Mode)

先停止正在使用该数据目录的任何其他 Daemon 实例,然后调整 native 配置块:

"native": {
"mode": "managed",
"accountId": "ACCOUNT_ID",
"dataDir": "/home/you/.local/share/agent-wechat",
"listen": "127.0.0.1:6174",
"token": { "source": "env", "provider": "default", "id": "AGENT_WECHAT_TOKEN" },
"consumerStateDir": "/home/you/.openclaw/agent-wechat"
}

OpenClaw 默认会在系统的 PATH 路径中查找 wx,也可以通过 executable 显式指定其绝对路径。在切换到托管模式前,请先使用 CLI 登录该账号;插件本身不会自动为你唤起交互式登录。