1. 企业微信机器人接 OpenClaw 到底难在哪企业微信智能机器人接入 OpenClaw核心要解决的是「消息怎么从企微到 OpenClaw、回复怎么从 OpenClaw 回到企微」这条链路。企业微信官方给了两种通道回调 URL 模式和长连接Websocket模式。前者需要你有公网域名、备案、HTTPS 证书还要处理企微服务器的签名校验后者由 OpenClaw 主动向企微建立 Websocket 通道不需要公网入口内网机器、本地开发机都能跑通。这篇面向的是需要在企业微信侧搭一条稳定机器人通道的开发者尤其是手里只有一台内网服务器、又不想折腾域名证书的人。我会把 config.toml 和 settings.json 的骨架直接给出来把 TaoToken 作为统一 Key/API 通道接进去最后用一条真实消息验证长连接是否建立、消息是否回环。整套流程走完你应该能在企业微信里对着自己创建的机器人发消息并收到 OpenClaw 的回复。需要提前说清楚一点长连接模式省掉的是公网暴露面不是省掉鉴权。Bot ID 和 Secret 仍然是身份凭证泄露了别人就能冒充你的机器人。所以配置文件别提交到公开仓库Secret 用环境变量注入更稳妥。2. 前置准备TaoToken 统一 Key 与 OpenClaw 环境2.1 为什么这里要引入 TaoTokenOpenClaw 本身是消息编排层它要调用大模型才能产生回复。如果你在 OpenClaw 里直接写某一家厂商的 base_url 和 key后面换模型、加备用通道都要改配置。TaoToken 提供的是 OpenAI 兼容的统一 API 通道base_url 固定、key 统一OpenClaw 侧只认一个地址模型切换在服务端完成。对长连接场景来说这能减少一类排障变量消息通道和模型通道分开出问题时能快速定位是 Websocket 断了还是模型调用失败了。TaoToken 官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意这个地址后面不加任何查询参数。你需要在控制台创建一个 API Key后面写进 OpenClaw 的模型配置里。2.2 环境与依赖检查企业微信客户端装好并登录版本尽量新旧版本的工作台里可能找不到「智能机器人」入口。OpenClaw 这边本地部署或云服务器部署都行确认进程能正常启动、日志能输出。如果跑在云服务器上安全组不需要为长连接额外开入站端口因为连接是 OpenClaw 主动发起的出站 Websocket只要服务器能访问外网即可。Node 或 Python 运行时按 OpenClaw 的安装说明准备配置文件目录通常在~/.openclaw/或项目根目录下的config/具体以你安装时的输出为准。下面给的路径按~/.openclaw/写你按实际位置替换。3. 可复制配置config.toml 与 settings.json 骨架3.1 创建企微机器人并拿到凭证打开企业微信客户端进工作台找到智能机器人应用点创建机器人。创建方式选 API 模式连接方式务必选长连接Websocket。创建完成后进入详情页记录两个字段Bot ID 和 Secret。这两个值就是后面 config.toml 里要填的。注意Secret 只在创建时完整展示页面刷新后可能不再明文显示先复制到安全的地方。3.2 config.toml 渠道配置骨架OpenClaw 的渠道配置写在 config.toml 里。下面这段可以直接抄把尖括号部分替换成你的真实值[channels.wecom] type wecom mode websocket bot_id YOUR_BOT_ID secret YOUR_BOT_SECRET reconnect_interval 5 heartbeat_interval 30 log_level info [model] provider openai-compatible base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_API_KEY model gpt-4o-mini timeout 60几个参数说明一下。mode必须是websocket写成callback就走回调 URL 模式了。reconnect_interval是断线重连间隔单位秒网络抖动时靠它自动恢复。heartbeat_interval是心跳间隔企微侧对空闲连接有超时策略心跳太稀会被判定掉线。base_url填 TaoToken 的 API 地址注意结尾不要带斜杠也不要加 UTM 参数。3.3 settings.json 补充配置有些 OpenClaw 版本把运行时开关放在 settings.json 里和 config.toml 分工不同。下面这份是常见骨架{ channel: { wecom: { enabled: true, transport: websocket, auto_reconnect: true, max_retry: 10 } }, model: { endpoint: https://taotoken.net/api, stream: true }, logging: { level: info, file: ~/.openclaw/logs/wecom.log } }stream打开后模型回复是流式返回的企微侧会看到消息逐步补全。如果你的 OpenClaw 版本不支持流式转发到企微把它设成 false 更稳。max_retry控制重连次数上限设太小会在网络恢复前就放弃设太大又可能一直重试10 次是个折中值。3.4 用命令行添加渠道可选如果你不想手改配置文件OpenClaw 提供了交互式命令openclaw channels add执行后按提示选渠道类型为「企业微信」依次输入 Bot ID 和 Secret在[select ...]处选finish完成基础配置。之后终端会问配对方式选Pairing。这条路径和手改配置等价选一种即可不要两边都配否则可能出现重复渠道。4. 建立长连接与消息回环验证4.1 启动并观察连接日志配置写好后启动 OpenClawopenclaw start --config ~/.openclaw/config.toml观察日志里是否出现类似wecom websocket connected或channel wecom ready的行。如果只看到connecting没有connected多半是 Bot ID 或 Secret 填错了或者服务器出站被限制。可以用 curl 先确认能访问 TaoToken 的 API 地址curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api返回 200 或 401 都说明网络通401 只是没带 key不影响判断连通性。4.2 触发配对长连接建立后双方还需要一次握手配对。回到企业微信找到你创建的机器人发一条任意消息比如「你好」。此时机器人会回复一条包含配置指引的消息最后一行是一串密钥形如PAIRING:ABCD-EFGH-IJKL。复制这一整行回到 OpenClaw 终端粘贴并回车。终端显示Successfully configured channel或类似提示就说明配对完成。4.3 验证消息回环配对成功后再在企业微信里发一条消息。这次应该收到来自 OpenClaw 的智能回复。如果回复内容明显是模型生成的说明整条链路通了企微 → Websocket → OpenClaw → TaoToken API → 模型 → 原路返回。你可以在日志里看到对应的请求记录确认模型调用走的是https://taotoken.net/api。5. 本篇常见错排查5.1 配对密钥无效最常见的原因是复制不完整。企微回复是多行文本只有最后一行是密钥前面是说明文字。粘贴时注意终端里不要带多余空格或换行。如果反复失败用openclaw channels list看渠道状态必要时openclaw channels remove 渠道ID删掉重加。5.2 长连接频繁断开先看日志里的断开原因。如果是心跳超时把heartbeat_interval调小到 15 秒试试。如果是网络层断开检查服务器出站是否稳定reconnect_interval可以设成 3 秒加快恢复。企业微信侧对同一 Bot 的连接数有限制别用同一个 Bot ID 在多台机器上同时连。5.3 消息发出但无回复分两步定位。先看 OpenClaw 日志有没有收到消息事件没有就是 Websocket 通道问题有收到但没回复就是模型调用失败。模型侧重点查三处base_url是否写成https://taotoken.net/api不带斜杠、不带参数、api_key是否有效、model名称是否在 TaoToken 支持的列表里。可以用模型对话页面单独测一下 key 是否可用。5.4 想改配置或换模式改配置直接编辑 config.toml 后重启 OpenClaw。想从长连接换成回调 URL 模式需要公网域名和 HTTPS 证书在企微后台填回调地址OpenClaw 侧把mode改成callback并配 URL 和 Token。内网环境不建议换长连接已经够用。6. 后续接入与 Key 管理整套流程跑通后你手里其实有两个需要长期维护的东西企微机器人的 Bot ID/Secret以及 TaoToken 的 API Key。前者决定消息通道能不能建起来后者决定模型能不能调通。建议把 Secret 和 API Key 都放进环境变量config.toml 里用占位符引用避免明文躺在磁盘上。如果你后面要接更多渠道比如把同一个 OpenClaw 同时挂到多个机器人上TaoToken 的统一 Key 优势会更明显模型侧只维护一份配置渠道侧各自独立。需要新建或轮换 Key 时到 API Keys 页面操作即可。模型选型和连通性测试可以直接在模型对话页面里试不用改 OpenClaw 配置。长期跑编码类或 Agent 类任务、调用量比较大的场景可以看一下 Coding Plan 的额度方案比按次调用更可控。接入文档里有完整的参数说明和示例遇到配置项拿不准的时候对着查一遍比反复重启试错快得多。