OpenClaw 与微信（企业微信）集成完整步骤：TaoToken 统一 Key 配置实战

1. 为什么我建议你走企业微信这条路OpenClaw 本身是个能跑在本地的智能体网关能读文件、执行命令、调模型但它的消息入口一直是个门槛。官方目前只支持企业微信WeCom作为国内 IM 通道个人微信直连属于第三方方案账号风险高不建议碰。企业微信的好处是免费注册、自建应用无需审核、回调走标准 AES 加解密链路合规可控。这篇要解决的就是「OpenClaw 接入企业微信」这条完整链路从企业微信后台建应用、拿 CorpId/Secret/AgentId到本地装wecom-app插件、写config.toml和settings.json、配 TaoToken 统一 Key再到回调 URL 验证和消息收发联调。适合已经部署好 OpenClaw、想用微信当入口的开发者也适合想把本地 Agent 接到办公 IM 的运维同学。全程命令可复制踩坑点我会标出来。2. TaoToken 前置统一 Key 与模型接入OpenClaw 调模型需要一个 OpenAI 兼容的 endpoint。TaoToken 提供统一 Key把 Claude、GPT 等模型的调用收敛到一个地址和一把 Key 上省得在settings.json里到处填不同厂商的 base_url。你只需要在 TaoToken 控制台 生成 API Key然后在 OpenClaw 的模型配置里指向https://taotoken.net/api即可。先确认 OpenClaw 能正常跑openclaw --version openclaw gateway status如果gateway status显示 running说明基础环境没问题。接着去 API Keys 页面 创建一把 Key复制备用。想先验证模型通不通可以直接在 模型对话 里发一条测试消息确认 Key 有效再往下走。注意TaoToken 的 API 地址是https://taotoken.net/api不要带 UTM 参数拼到代码里UTM 只用于文档跳转。3. 企业微信后台建应用与拿凭证打开 企业微信管理后台用个人微信扫码注册一个企业个人使用填虚拟信息即可。进入「应用管理 → 自建应用 → 创建应用」名称填OpenClaw AI可见范围选「仅自己」。创建完成后在应用详情页复制三个值凭证位置用途CorpId我的企业 → 企业信息标识企业AgentId应用详情页标识应用Secret应用详情页仅显示一次调用接口鉴权然后进「接收消息 → 设置 API 接收」点随机生成Token和EncodingAESKey43 位消息加密方式选「兼容模式」。URL 先填占位http://你的公网IP:18789/wecom-app先别点保存等 OpenClaw 配置完再回来验证。最后到「开发者接口 → 企业可信IP」把你的公网 IP 加进去否则回调会被拒。4. 可复制配置插件安装与 config.toml 骨架安装官方企业微信插件openclaw plugins install openclaw-china/wecom-app openclaw plugins list看到wecom-app就说明装好了。接下来编辑~/.openclaw/openclaw.json在channels下加入企业微信配置。下面这份config.toml骨架可以直接对照改[channels.wecom-app] enabled true webhookPath /wecom-app token 你的Token encodingAESKey 你的43位EncodingAESKey corpId ww1234567890abcdef corpSecret 你的Secret agentId 1000001如果你用的是 JSON 版配置等价片段如下wecom-app: { enabled: true, webhookPath: /wecom-app, token: abc123xyz, encodingAESKey: 43位随机字符串, corpId: ww1234567890abcdef, corpSecret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, agentId: 1000001 }模型侧在settings.json里指向 TaoToken{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的TaoTokenKey, model: claude-sonnet-4-5 } }改完重启网关openclaw gateway restart openclaw gateway status openclaw logs --followlogs --follow会实时打印回调请求验证 URL 时盯着它最有用。5. 验证请求回调 URL 与消息收发联调回到企业微信后台的「接收消息设置」点保存。企业微信会向http://你的公网IP:18789/wecom-app发一条 GET 验证请求OpenClaw 用token和encodingAESKey解密并回显echostr。日志里出现类似wecom-app verify success就说明通了。接着在应用里发一条消息测试/status /model/status返回网关状态/model可以切换模型。群聊里 应用名称也能触发。如果想让个人微信收到回复进企业微信 App → 工作台 → OpenClaw AI → 右上角「…」→ 关联微信用个人微信扫码关注之后在个人微信的「企业号」里就能直接对话。6. 本篇常见错排查URL 验证失败九成是token或encodingAESKey对不上或者网关没启动。先openclaw gateway status确认 running再核对配置里的两个值是否和后台生成的一致。收不到消息检查公网 IP 和 18789 端口是否放行企业可信 IP 是否加了当前出口 IP。用curl http://你的公网IP:18789/wecom-app看是否有响应。个人微信收不到回复确认企业微信应用已发布、可见范围包含自己、关联微信已完成。应用没发布时个人微信侧看不到入口。模型调用报 401settings.json里的 TaoToken Key 填错或过期去 API Keys 重新生成。长期跑编码和 Agent 任务的话可以看下 Coding Plan额度更划算。Secret 泄露风险Secret 只在创建时显示一次别写进公开仓库。公网部署建议加防火墙只放行企业微信回调 IP 段。7. 下一步把入口跑顺回调验证通过、消息能收发之后这套链路就算跑通了。我自己的习惯是先在 模型对话 里确认模型响应正常再回企业微信发指令测试端到端。接入细节和参数说明都在 接入文档 里遇到报错先翻日志再对照文档比盲改配置快得多。