1. 为什么 OpenClaw 接微信总卡在配置这一步OpenClaw 是一个可以跑在 Linux 和 macOS 上的开源智能体网关装完之后它能对接飞书、企业微信、微信等渠道把大模型能力塞进你日常用的聊天工具里。适合谁适合手里有一台云服务器或者本地 Mac、想让 AI 助手直接在企业微信里收发消息的开发者。但真正动手的人会发现安装脚本跑完只是开始接入微信/企业微信的配置环节才是最容易翻车的地方——插件装完不知道填什么、config.toml 和 settings.json 骨架长什么样、消息发出去没回音、企业微信后台保存报错这些坑我基本都踩过一遍。这篇聚焦 Linux 与 macOS 上 OpenClaw 安装后接入微信/企业微信的配置环节给出 TaoToken 统一 Key/API 通道的 config.toml 与 settings.json 骨架并演示一次消息收发验证动作。核心思路是把模型调用通道统一收敛到 TaoToken 的 API 上用一把 Key 打通 OpenClaw 的模型请求这样你就不用为每个渠道单独配一堆模型凭据排错时也只需要盯一个地方。前置条件说清楚Node.js 版本要大于 22npm 大于 10CentOS 版本要大于等于 8。企业微信这边必须已经注册完成企业微信用户并且有管理员权限去创建自建应用。下面按 Linux 和 macOS 两条线走命令基本通用差异我会单独标出来。2. TaoToken 前置统一 Key 与 API 通道准备在动 OpenClaw 的配置文件之前先把模型调用通道准备好。TaoToken 在这里扮演的角色是统一的模型 API 入口OpenClaw 通过它去请求模型你只需要维护一把 Key。先去控制台创建 API Key地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建完把 Key 复制下来形如sk-xxxxxxxx后面 config.toml 里要用。API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 填进去。如果你用的是兼容 OpenAI 协议的客户端配置方式OpenClaw 的模型段也是按这个格式走的。注意Key 只创建一次就够多个渠道微信、企业微信、飞书共用同一把 Key这正是统一通道的意义。不要把 Key 写进会提交到 Git 的文件里用环境变量或者本地配置文件。想先确认这把 Key 能不能正常对话可以直接在模型对话页面发一条测试消息https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。能正常返回说明 Key 和通道没问题再往下配 OpenClaw 就排除了模型侧的变量。如果你后面要长期跑编码类 Agent 任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 不过本篇的微信接入用普通 API Key 就够了。3. 可复制配置config.toml 与 settings.json 骨架3.1 依赖与 OpenClaw 安装Linux / macOS先装 Node.js。用 NVM 管理版本最省事# 安装 NVM curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bash_profile # 安装并切换到 Node 24 nvm install 24.14.0 nvm use 24.14.0 node -v # 需要 22.xx npm -v # 需要 10.xxmacOS 上如果source ~/.bash_profile不生效换成source ~/.zshrc因为新版 macOS 默认 shell 是 zsh。装 OpenClaw一键脚本会检测 nodejs 和 git# 切换国内 npm 镜像源加速安装 npm install -g nrm nrm ls nrm use cnpm # 一键自动安装 curl -fsSL https://openclaw.ai/install.sh | bash # 或者手动安装 npm install -g openclawlatest openclaw onboard --install-daemonopenclaw onboard --install-daemon会把 OpenClaw 注册成后台服务Linux 上是 systemdmacOS 上是 launchd这样重启机器后网关会自动拉起。3.2 config.toml 骨架OpenClaw 的主配置在~/.openclaw/config.toml。下面这份骨架把模型通道指向 TaoToken并预留了企业微信插件段# ~/.openclaw/config.toml [gateway] # 监听端口企业微信回调要用 port 18789 # 绑定网卡lan 表示允许局域网访问 bin lan [model] # 统一走 TaoToken 通道 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o-mini [channels.wecom_app] enabled true # 以下四项从企业微信后台复制先留空setup 向导会填 corp_id agent_id corp_secret token encoding_aes_key gateway.bin设成lan是为了让企业微信的回调能打到你的服务器。如果你只在本地 Mac 上跑用 SSH 端口转发把 18789 映射出来也行后面验证环节会讲。3.3 settings.json 骨架部分 OpenClaw 版本把渠道凭据放在~/.openclaw/settings.json和 config.toml 配合使用。骨架如下{ channels: { wecom_app: { enabled: true, corpId: ww你的企业ID, agentId: 1000002, corpSecret: 你的应用Secret, token: 企业微信API接收消息的Token, encodingAESKey: 企业微信API接收消息的EncodingAESKey, replyMode: stream } }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey } }两个文件里模型段保持一致避免出现「config.toml 改了但 settings.json 还是旧 Key」这种低级错误。实测下来OpenClaw 读取优先级是 settings.json 覆盖 config.toml所以改 Key 的时候两个都检查一遍。3.4 安装企业微信插件openclaw plugins install openclaw-china/wecom-app安装成功后会看到插件注册日志最后提示下一步运行交互式配置向导openclaw china setup向导会依次问你Wecom App token、encodingAESKey、corpId、corpSecret、agentId以及是否继续配置其他渠道。token 和 encodingAESKey 从企业微信后台「API 接收消息配置」里复制corpId 在「我的企业」里找企业 IDcorpSecret 和 agentId 在自建应用里。4. 验证请求一次消息收发跑通4.1 启动网关并观察日志openclaw gateway --port 18789 --verbose--verbose会打印每条进来的消息和模型请求排错时必开。看到OpenClaw China Channels 已就绪说明插件加载成功。4.2 本地访问工作台远程服务器场景如果 OpenClaw 跑在云服务器上本地机器用 SSH 端口转发把工作台映射出来ssh -N -L 18789:127.0.0.1:18789 root你的服务器IP首次连接会提示确认 ED25519 指纹输入yes然后输入服务器密码。保持这个终端不要关本地浏览器访问http://127.0.0.1:18789/就能打开 OpenClaw 工作台。4.3 企业微信后台配置回调在企业微信管理后台创建自建应用完成应用信息、选择可见成员。进入「API 接收消息配置」把 URL 填成你的网关地址加回调路径Token 和 EncodingAESKey 点随机生成后复制到 setup 向导里。这里有个关键点必须先把 OpenClaw 服务器插件配置完成企业微信后台才能保存成功否则会提示配置未完成。所以顺序是「装插件 → 跑 setup → 回后台保存」。保存成功后在「企业可信 IP」里把你的服务器公网 IP 加进去否则企业微信会拒绝回调。4.4 发一条消息验证在企业微信里找到这个应用给机器人发一条「你好」。观察网关日志应该能看到类似[wecom_app] received message: 你好 [model] POST https://taotoken.net/api/chat/completions [wecom_app] reply sent: 你好我是你的 AI 助手...企业微信里收到回复说明整条链路通了企业微信 → OpenClaw 网关 → TaoToken API → 模型 → 原路返回。如果日志里模型请求报 401就是 Key 填错了如果企业微信侧收不到回复检查可信 IP 和回调 URL。5. 本篇常见错排查报错一node -v低于 22。OpenClaw 依赖新版 Node 特性低于 22 会在启动时报语法错误。用nvm install 24.14.0 nvm use 24.14.0切过去然后重新openclaw onboard。报错二企业微信后台保存提示「配置未完成」。这是最常见的坑。原因是 OpenClaw 服务器侧插件还没配好企业微信无法验证回调。解决顺序先openclaw plugins install openclaw-china/wecom-app再openclaw china setup填完凭据最后回后台保存。报错三模型请求 401 Unauthorized。Key 不对或者 base_url 写错。检查 config.toml 和 settings.json 里的api_key是否都是同一把 TaoToken Keybase_url是否是https://taotoken.net/api不要带尾部斜杠也不要带查询参数。改完重启网关。报错四企业微信收不到回复日志无 incoming message。大概率是可信 IP 没配或者回调 URL 的端口没放行。云服务器安全组要放行 18789企业微信后台「企业可信 IP」要加服务器公网 IP。报错五SSH 端口转发后浏览器打不开工作台。检查ssh -N -L命令是否还在前台运行-N表示不执行远程命令只做转发终端关了转发就断了。另外确认本地 18789 端口没被其他程序占用。报错六插件安装后日志没有OpenClaw China Channels 已就绪。可能是 npm 镜像源问题导致插件包下载不全。nrm use cnpm后重新openclaw plugins install openclaw-china/wecom-app或者清掉~/.openclaw/plugins缓存重装。排障时如果拿不准是模型侧还是渠道侧的问题先去模型对话页面单独测一把 Keyhttps://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。模型侧通了问题就锁定在 OpenClaw 配置或企业微信后台。6. 接入完成后怎么继续用配置跑通之后日常维护其实就三件事Key 轮换、日志观察、渠道扩展。Key 轮换时记得 config.toml 和 settings.json 同步改改完openclaw gateway restart。日志用openclaw gateway --verbose前台跑或者看 systemd/launchd 的日志文件。如果你后面要加飞书或者其他渠道插件安装和 setup 流程是一样的模型段不用动因为统一走 TaoToken 通道。接入文档和参数细节可以对照官方说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。长期跑编码类 Agent 任务的话Coding Plan 会比按量计费更划算配置方式在控制台里能看到https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。最后留一个实用技巧把openclaw china setup填过的凭据在本地留一份备份脱敏后下次换服务器或者重装时直接对照填能省掉重新去企业微信后台翻 Token 的时间。企业微信的 Token 和 EncodingAESKey 一旦重新生成旧的就失效所以备份时标注好生成时间。
