跳转到内容

配置参考

Daemon 服务端配置

默认配置文件位于 ~/.config/agent-wechat/server/config.toml。该文件为可选配置。

schemaVersion = 1
listen = "127.0.0.1:6174"
# dataDir = "/srv/agent-wechat" # 默认:~/.local/share/agent-wechat
# tokenFile = "/srv/secrets/api-token" # 默认:<dataDir>/api-token,初次启动时自动生成
配置键启动标志环境变量
配置文件--server-configAGENT_WECHAT_SERVER_CONFIG
dataDir--data-dirAGENT_WECHAT_DATA_DIR
listen--listen
networkListen--network-listen
tlsCertFile--tls-cert-file
tlsKeyFile--tls-key-file

listen 仅限绑定在环回接口 (Loopback)。若需接收来自外部设备的 HTTPS 连接,需同时配置以下三项网络参数:

networkListen = "0.0.0.0:7443"
tlsCertFile = "/srv/secrets/certificate.pem"
tlsKeyFile = "/srv/secrets/private-key.pem"

建议使用独立的网络端口,并对 TLS 证书及私钥文件做好文件权限收紧保护,仅允许服务端用户读取。外部连接依然必须携带合法 API 令牌。CLI 默认信任系统公认 CA 根证书;传入 --ca-cert-file 可以在单次调用中引入自签名证书。

配置文件中的相对路径相对于配置文件所在目录进行解析。设置 XDG_CONFIG_HOME 和 XDG_DATA_HOME 可重定向默认路径。未识别的配置键将被严格拒绝。

OpenClaw 通道配置

配置位于 openclaw.json 中的 channels.agent-wechat 下。其中的 native 配置块也可以放置在 plugins.entries.agent-wechat.config 下。

配置项默认值作用说明
enabled开启或关闭该通道
dmPolicy, allowFromdisabled单聊控制策略
groupPolicy, groupAllowFrom, groupsdisabled群聊控制策略
mediaMaxMb50附件大小上限 (MiB),同时作用于拉取与外发源文件;外发时仍受 Daemon 各类型的硬性上限约束。参见附件大小限制。
native.modeexternal(外部模式)或 managed(托管模式)。参见托管与外部模式。
native.accountId账号 ID(通过 wx accounts list 获取)
native.endpointDaemon 服务 URL(仅用于外部模式)
native.executable, native.listen, native.dataDir, native.serverConfig仅用于托管模式的相关路径与参数
native.token访问令牌引用声明(见下文)
native.consumerStateDir存放 OpenClaw 消费进度的目录;需做持久化挂载
native.readPolicyon_inbound已读回执策略
native.gatewayFacade关闭设为 {"enabled": true} 时可通过 Gateway 在 /plugins/agent-wechat/native 代理暴露 Daemon API,并使用 Gateway 认证

native.token 支持 OpenClaw 的任意 Secret 引用格式:

"token": { "source": "env", "provider": "default", "id": "AGENT_WECHAT_TOKEN" }

也支持类似 "${AGENT_WECHAT_TOKEN}" 的语法。若引用的密钥无法被解析,通道将直接报错中断启动,而绝不静默降级为其他令牌。更改令牌后请重启 Gateway。

CLI 客户端配置

~/.config/agent-wechat/client.toml 用于存储通过 wx config servers add 添加的服务器列表以及每个服务器的默认账号。CLI 独立读取各服务器配置的令牌文件。--token-stdin 支持通过私有管道标准输入传入令牌(适用于单次 HTTP 调用或 serve),该标志不可与 --token-file 混用。环境变量对应关系参见全局标志。

使用 wx config servers list 中展示的名称移除已保存的服务器配置:

Terminal window
wx config servers remove box
Active Server: —
Server: box
State: removed

移除当前处于激活状态的服务器条目会清空当前的默认服务器选择。关联的令牌文件与已注册的本地 Profile 会完整保留。

安装器相关环境变量

环境变量作用机制
AGENT_WECHAT_NATIVE_BINARY强制使用指定的本地 wx 二进制文件,跳过自动下载
AGENT_WECHAT_NATIVE_ARTIFACT_DIR从指定的本地发布制品目录安装(用于离线部署)
AGENT_WECHAT_SKIP_NATIVE_INSTALL=1在执行 npm install 期间跳过二进制下载
TMPDIRDaemon 存放离线审查临时数据库快照的目录