1. 企业微信里塞进一个 AI 助手到底卡在哪企业微信做智能办公最直接的需求就是让同事在聊天框里问一句机器人能答上来。听起来简单真动手就会发现三个绕不开的坎企业微信后台要建应用、要配回调、要拿鉴权凭证机器人侧要接消息、要回消息、要保持长连接不掉线中间还得有个稳定的模型通道不然问一句转三秒同事直接把你拉黑。我见过太多团队卡在第二步——企业微信的 Bot ID 和 Secret 拿到了OpenClaw 也装好了结果消息发出去石沉大海日志里一堆local proxy failed或者401。问题往往不在企业微信而在模型通道没打通或者回调地址和长连接模式选错了。这篇就按真实落地顺序走一遍先在企业微信后台把 API 模式机器人建出来拿到 Bot ID 和 Secret再在 OpenClaw 里填凭证、开渠道、重启网关然后配好 TaoToken 统一通道让模型请求走一个稳定的 Base URL最后发一条消息验证收发闭环。全程不需要公网 IP内网环境也能跑。适合谁看正在给公司搭内部 AI 助手的技术同学、被企业微信回调配置折磨过的运维、以及想用 OpenClaw 快速接一个办公平台但不想从零写代码的人。核心检索词就三个企业微信、OpenClaw、智能办公对接。下面每一步都给可复制的配置和参数对照照着做就能跑通。2. 企业微信侧建机器人API 模式与长连接怎么选企业微信后台建机器人入口在「工作台」→「智能机器人」→「创建机器人」→「手动创建」。这里有个关键分叉选 URL 回调还是选 API 长连接。很多人默认选了 URL 回调结果发现要公网域名、要配可信 IP、要处理加解密内网环境直接卡死。长连接模式的好处是不需要域名和公网 IPOpenClaw 主动连企业微信的网关消息通过这条长连接推过来。对本地部署和内网环境来说这是唯一省心的选择。代价是 API 模式暂不支持预览和调试建完直接保存调试得在 OpenClaw 侧看日志。具体操作路径登录企业微信管理后台用管理员账号进「工作台」→「智能机器人」点「创建机器人」选「手动创建」。进入创建页后连接方式选「使用长连接」。页面会提示如需使用自有系统获取成员与机器人的聊天并输出回复可切换至 API 模式创建。确认后系统自动生成 Bot ID 和 Secret这两个值必须立刻保存页面刷新后 Secret 不再完整显示。补充配置里把机器人可见范围设成你需要的那几个部门或全员其余保持默认。保存后机器人就建好了但此时它还不会回消息因为 OpenClaw 侧还没接上。这里有个容易踩的坑有人建完机器人发现「智能机器人」列表里能看到但发消息没反应以为是企业微信的问题。其实 API 模式下机器人本身不处理消息它只是把消息通过长连接推给 OpenClawOpenClaw 处理完再通过同一条连接回推。所以机器人建好只是第一步真正的处理逻辑在 OpenClaw 和模型通道那边。参数对照表先放这里后面 OpenClaw 配置时直接对着填企业微信后台项值来源OpenClaw 对应字段Bot ID创建机器人后自动生成企业微信渠道 Bot IDSecret创建机器人后自动生成企业微信渠道 Secret连接方式选「使用长连接」渠道模式选长连接可见范围按需选部门/全员无需填企业微信侧控制建完机器人企业微信侧的工作就完成了。接下来去 OpenClaw 里把凭证填进去。3. OpenClaw 侧配置凭证、渠道与 TaoToken 统一通道OpenClaw 打开后先确认 Gateway 在线状态栏显示绿色或「运行中」。然后进渠道配置选「企业微信 (WeCom)」。把上一步拿到的 Bot ID 和 Secret 分别填进去连接方式选长连接保存后确认渠道已启用重启网关生效。到这一步企业微信的消息能推到 OpenClaw 了但 OpenClaw 要回消息得调模型。如果模型通道没配好你会看到消息进来了但回复超时日志里报local proxy failed或者401 Unauthorized。所以接下来配 TaoToken 统一通道。TaoToken 的作用是把模型请求收敛到一个 Base URL 上Key 统一管理换模型不用改代码。OpenClaw 的模型配置里把 Base URL 填成https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台生成的 KeyModel ID 填你要用的模型名。配置文件片段OpenClaw 的模型通道配置JSON 格式路径按你实际安装目录调整{ model_providers: { taotoken: { base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model_id: claude-3-5-sonnet, timeout: 60 } }, channels: { wecom: { enabled: true, bot_id: 你的BotID, secret: 你的Secret, mode: long_connection } } }如果你用的是 TOML 格式的配置等价写法[model_providers.taotoken] base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_id claude-3-5-sonnet timeout 60 [channels.wecom] enabled true bot_id 你的BotID secret 你的Secret mode long_connection三件套必须齐全Base URL、Key、Model ID。少一个都会在请求时失败。Base URL 用https://taotoken.net/api不要加多余路径。Key 在 TaoToken 控制台的 API Keys 页面生成生成后只显示一次复制保存。Model ID 按你实际要用的模型填比如claude-3-5-sonnet、gpt-4o等具体可用列表在模型对话页面能查到。配完后重启 OpenClaw 网关。重启动作很关键很多人改完配置没重启渠道还是旧状态消息照样不通。4. 发一条消息验证从企业微信到模型再回来配置完成后验证动作要简单直接在企业微信里找到你刚建的机器人发一句「你好帮我查一下今天的待办」。预期结果是几秒内机器人回复一段正常文本。如果没回复按这个顺序查先看 OpenClaw 的 Gateway 日志有没有收到企业微信推过来的消息。如果日志里完全没有消息记录说明长连接没建起来回企业微信后台确认机器人连接方式是「使用长连接」且 OpenClaw 侧渠道已启用、网关已重启。如果日志里有消息进来但没有模型请求记录说明渠道到模型的链路断了。检查 TaoToken 的 Base URL 和 Key 是否正确Model ID 是否在可用列表里。如果日志里有模型请求但报错看具体错误码。401是 Key 无效或过期去 TaoToken 控制台重新生成local proxy failed通常是 Base URL 写错或网络不通确认填的是https://taotoken.net/apireading choices这类错误一般是模型返回格式和 OpenClaw 预期不匹配换一个 Model ID 试试。验证通过后你可以再发一条稍微复杂点的比如「把这段话翻译成英文明天下午三点开会」。如果也能正常回复说明整条链路稳定了。联调时建议开两个窗口一个企业微信聊天窗口一个 OpenClaw 日志窗口。发消息的同时看日志能快速定位是哪个环节卡住。实测下来大部分问题都出在 Key 填错、Base URL 多写了路径、或者改完配置没重启网关这三件事上。5. 常见报错排查401、local proxy failed、reading choices这一节把对接过程中最常撞见的几个报错拆开说每个都给排查路径。401 Unauthorized模型请求被拒。原因通常是 TaoToken 的 API Key 无效、过期或者复制时带了空格。去 TaoToken 控制台的 API Keys 页面确认 Key 状态重新生成一个粘贴时注意不要带首尾空格。如果 Key 没问题检查 Base URL 是否写成了https://taotoken.net/api/末尾多斜杠有时也会导致鉴权失败改成不带末尾斜杠的https://taotoken.net/api。local proxy failed本地代理失败。这个报错在 OpenClaw 日志里出现时一般是 Base URL 不可达或 DNS 解析失败。先确认网络能访问https://taotoken.net/api再确认配置里的 Base URL 没有拼写错误。如果你之前配过其他代理设置检查是否残留了旧的代理配置覆盖了当前通道。reading choices 相关错误模型返回结构不符合预期。常见于 Model ID 填了一个 OpenClaw 不认识的模型名或者该模型返回的 JSON 结构和 OpenClaw 解析逻辑不匹配。解决办法是换一个明确支持的 Model ID比如claude-3-5-sonnet或gpt-4o在模型对话页面确认可用后再填。OAuth 相关报错如果你在配置过程中看到 OAuth 字样通常和企业微信侧的鉴权有关。企业微信 API 模式用的是 Bot ID Secret不走 OAuth。如果日志里出现 OAuth 错误检查是否误选了 URL 回调模式或者 OpenClaw 渠道配置里混入了其他平台的鉴权字段。把渠道配置清空重填只保留 Bot ID、Secret 和长连接模式。消息发出去了但机器人不回先看 OpenClaw 日志有没有收到消息。没收到就是长连接问题收到但没回复就是模型通道问题。分两步查不要混在一起。改了配置不生效OpenClaw 的渠道配置改完后必须重启网关。很多人改完直接发消息发现还是旧行为以为配置没保存。养成改完就重启的习惯。排查时有个技巧把 OpenClaw 日志级别调到 debug能看到完整的请求和响应体。但注意日志里可能包含 Key 的部分字符排查完记得调回正常级别。6. 通道配好之后日常怎么用整条链路跑通后日常使用就是企业微信里直接聊。同事在机器人对话框里问问题OpenClaw 通过长连接收消息调 TaoToken 通道请求模型再把回复推回企业微信。整个过程不需要公网 IP内网部署也能稳定跑。如果你要换模型只改 OpenClaw 配置里的 Model IDBase URL 和 Key 不用动。TaoToken 统一通道的好处就在这里模型切换对上层透明企业微信侧完全无感。长期跑的话建议把 TaoToken 的 Key 和 OpenClaw 的渠道配置分开管理Key 定期轮换配置用版本控制存一份。这样换人维护时不用重新摸索。需要生成 Key 或查可用模型去 TaoToken 控制台的 API Keys 页面和模型对话页面。接入文档里有各语言的调用示例配 OpenClaw 时对照着看就行。如果后面要接钉钉或飞书OpenClaw 的渠道配置逻辑类似把企业微信那套凭证换成对应平台的即可模型通道还是走同一个 TaoToken Base URL。跑通之后你会发现企业微信智能办公最难的不是模型能力而是把消息链路和鉴权链路对齐。这两条链路通了后面加功能就是改配置的事。