1. OpenClaw 接企业微信机器人卡在 API 通道这一步的人最多OpenClaw 是一个可以把大模型能力接进日常聊天工具的开源网关企业微信机器人则是很多团队内部通知、问答、工单流转的入口。把这两者接起来你就能在企业微信里直接跟自己的模型对话不用切浏览器、不用开额外客户端。适合谁适合手里已经有一台常开的 Windows 或 Linux 机器、想给团队做一个内部 AI 助手的开发者也适合个人拿企业微信当私人助理入口的折腾党。但真正动手时绝大多数人卡的不是企业微信那边怎么建机器人而是 OpenClaw 这边的 API 通道怎么配。企业微信机器人给你的是 Bot ID 和 SecretOpenClaw 要的是模型通道的 Base URL、API Key、Model ID两套东西对不上配置写错一个字段表现就是机器人建好了、消息发出去了、然后石沉大海。更麻烦的是报错信息往往很含糊401、local proxy failed、reading choices 这些词一出来新手根本不知道是 Key 错了还是地址写歪了。我试过把模型通道和企业微信渠道拆开单独验证发现只要模型通道本身是通的企业微信这层其实很好接。所以这篇的思路是先用 TaoToken 统一 API 通道把模型侧跑通再回头配企业微信机器人的 Bot ID / Secret最后发一条消息做端到端验证。整条链路可复现每一步都有可复制的配置片段。核心检索词先摆出来OpenClaw 企业微信机器人接入、TaoToken 统一 API 通道配置、config.toml 骨架、企业微信机器人回调地址与 Token 校验。你如果是搜着这几个词进来的下面的内容基本能覆盖你的问题。需要提前说明的是企业微信机器人有两种模式一种是 webhook 群机器人只能发不能收一种是智能机器人的 API 模式能收能回走长连接。这篇讲的是后者因为只有 API 模式才能让 OpenClaw 真正接管对话。webhook 那种你只能单向推送做不了问答。另外OpenClaw 的模型通道配置和企业微信渠道配置是两件独立的事很多人混在一起调结果两边都乱。正确的顺序是先配模型通道、验证模型能回话再配企业微信渠道、验证消息能进来。顺序反了你会在企业微信里发消息然后对着一个不回复的机器人怀疑人生却不知道到底是模型没通还是渠道没通。下面从环境准备开始一步步来。全程不需要任何特殊网络手段就是正常的 API 调用和本地配置。2. TaoToken 前置准备统一 Key 与 API 通道怎么拿TaoToken 在这里扮演的角色是「统一 API 通道」。你可以把它理解成一个模型调用的统一入口不管你后面想用哪个模型OpenClaw 里只填一套 Base URL 和 Key换模型只改 Model ID 就行。对 OpenClaw 这种要长期挂着跑的网关来说统一通道省事很多不用每换一个模型就改一遍配置。前置准备分三件事拿到 API Key、确认 Base URL、想好要用哪个 Model ID。第一步打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。控制台里能看到你的账户状态和用量。第二步创建 API Key。进 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 点新建复制生成的 Key。这个 Key 通常以 sk- 开头只显示一次复制完先存到记事本里。注意别把 Key 直接提交到 Git 仓库后面配置里我们会用环境变量或者本地文件的方式引用。第三步确认 Base URL。TaoToken 的 API 端点是 https://taotoken.net/api 注意这个地址后面不加任何路径后缀OpenClaw 里填的就是这个根地址。很多 401 和 404 就是因为把 /v1 或者 /chat/completions 也拼进去了OpenClaw 自己会补全路径。第四步选 Model ID。如果你不确定用哪个可以先在模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里试几个看看哪个回复质量符合预期。记下你选中的 Model ID比如常见的 claude-sonnet 系列或者 gpt 系列具体以控制台里列出的为准。Model ID 是大小写敏感的复制的时候别手打。如果你后面打算长期跑编码类或 Agent 类任务可以了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合高频调用的场景。但这一步不是必须的先用按量计费的 Key 把链路跑通再说。前置准备的自检清单已注册并登录 TaoToken能进控制台已创建 API Key 并复制保存已确认 Base URL 是 https://taotoken.net/api已选定一个 Model ID 并记下本地机器能正常访问外网 API普通家庭宽带即可这五条都打勾了再往下走。少一条后面排障会多花半小时。3. 可复制配置config.toml 骨架与企业微信渠道参数这一节是全文的核心给你一份可以直接抄的 config.toml 骨架以及企业微信机器人那边要填的回调地址和 Token 校验配置。先说 OpenClaw 的配置文件位置。Windows 下通常在%USERPROFILE%\.openclaw\config.tomlLinux/macOS 下在~/.openclaw/config.toml。如果你是通过安装包部署的也可能在安装目录的config子目录里。找不到就用 OpenClaw 设置界面里的「打开配置目录」按钮直接跳过去。下面这份骨架模型通道部分填 TaoToken 的信息企业微信渠道部分填你从企业微信复制来的 Bot ID 和 Secret# ~/.openclaw/config.toml [gateway] # 网关监听端口默认即可 port 8787 # 保持在线OpenClaw 顶部状态会显示 Gateway 在线 enabled true [model] # TaoToken 统一 API 通道 base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id 你的ModelID # 请求超时单位秒长回复建议调大 timeout 120 [channels.wecom] # 企业微信智能机器人 API 模式 enabled true # 从企业微信 API 配置页复制 bot_id 你的BotID secret 你的Secret # 连接方式长连接 connection long # 回调地址OpenClaw 本地网关地址 callback_url http://127.0.0.1:8787/wecom/callback # Token 校验企业微信侧配置的 Token需与这里一致 verify_token 你的VerifyToken几个关键点解释一下。base_url必须是https://taotoken.net/api不要加/v1。OpenClaw 内部会按 OpenAI 兼容格式拼接/v1/chat/completions你多写一层就变成/api/v1/v1/...直接 404。api_key建议不要硬编码在文件里。更稳妥的做法是用环境变量OpenClaw 支持${TAOTOKEN_API_KEY}这种写法[model] base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model_id 你的ModelID然后在系统环境变量里设置TAOTOKEN_API_KEY。Windows 用setx TAOTOKEN_API_KEY sk-xxxLinux 写进~/.bashrc的export。这样配置文件可以安全地分享或提交。connection long对应企业微信 API 配置页里的「使用长连接」。如果你在企业微信那边选了别的连接方式这里要跟着改否则握手失败。callback_url和verify_token是企业微信回调校验用的。企业微信在配置机器人时会让你填一个回调地址和一个 Token用来验证请求确实来自企业微信。OpenClaw 本地网关跑在 8787 端口所以回调地址指向本机。如果你把 OpenClaw 部署在服务器上把127.0.0.1换成服务器内网 IP 或域名。企业微信那边的配置对应关系用一张表说清楚企业微信配置项OpenClaw config.toml 对应字段说明Bot IDchannels.wecom.bot_idAPI 配置页复制Secretchannels.wecom.secretAPI 配置页复制只显示一次连接方式长连接channels.wecom.connection long必须一致回调地址channels.wecom.callback_url指向 OpenClaw 网关Tokenchannels.wecom.verify_token两边必须完全相同如果你用的是 Cline MCP 或者 Codex 的 auth.json 那套体系思路是一样的Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填你选的模型。三件套缺一不可少一个就是 401 或者 reading choices 报错。配置写完保存文件重启 OpenClaw。重启后看顶部 Gateway 状态是不是在线。不在线的话先解决网关问题别急着测企业微信。4. 验证请求从模型通道到企业微信消息收发配置写完不代表通了必须做验证。验证分两层先验证模型通道再验证企业微信消息收发。分开验证的好处是出问题能立刻定位是哪一层。第一层验证 TaoToken 模型通道。不用打开 OpenClaw直接用 curl 打一发确认 Key 和 Base URL 没问题curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [ {role: user, content: 你好请回复一句话确认通道正常} ] }正常返回是一个 JSONchoices[0].message.content里有模型回复。如果返回 401说明 Key 错了或者没带上如果返回 404说明 Base URL 拼错了如果返回 model not found说明 Model ID 写错了。这一步通了模型通道就没问题。第二层验证 OpenClaw 网关。在浏览器或 curl 里访问本地网关的健康检查curl http://127.0.0.1:8787/health返回{status:ok}之类的就说明网关活着。如果连不上检查 OpenClaw 是否启动、端口是否被占用。第三层验证企业微信消息收发。这一步在企业微信客户端里做。打开你创建好的机器人点「去使用」进入聊天窗口发一条消息比如「你好」。如果机器人正常返回内容说明整条链路通了。如果机器人不回复先看 OpenClaw 的日志。日志里会打印收到的请求和模型调用结果。常见的情况是企业微信消息进来了但模型调用失败日志里会有 401 或 timeout。这时候回到第一层重新验证模型通道。再给一个更细的验证动作在 OpenClaw 日志里确认企业微信回调是否命中。正常命中会打印类似wecom callback received, verify_token matched的日志。如果没看到这行说明企业微信那边根本没把消息推过来问题在企业微信配置不在 OpenClaw。验证通过后你可以试着发一条稍微复杂点的消息比如「帮我总结一下今天的工作重点」看看模型回复是否完整。如果回复被截断可能是timeout设小了调大到 180 或 300 再试。这一步的验收标准很简单企业微信里发消息机器人有回复且回复内容来自你配置的模型。达到了接入就算完成。5. 常见报错排查401、local proxy failed、reading choices 怎么解接入过程中最常见的报错就那么几个逐个说清楚原因和解法。401 Unauthorized。这个几乎都是 Key 的问题。三种可能Key 复制时带了空格或换行Key 已经失效或被删除配置文件里引用的环境变量没生效。排查方法先用第 4 节的 curl 命令直接测 Key如果 curl 也 401就是 Key 本身的问题回控制台重新生成一个。如果 curl 通了但 OpenClaw 里 401就是配置文件读取的问题检查api_key那一行有没有拼写错误环境变量有没有重启终端。local proxy failed。这个报错通常出现在 OpenClaw 尝试连接模型通道时。原因可能是 Base URL 写成了https://taotoken.net/api/v1这种带后缀的地址导致路径拼接错误也可能是本地网络到 API 端点的连接被中断。先确认base_url是干净的https://taotoken.net/api再确认本机curl https://taotoken.net/api能通。如果本机 curl 都不通那是网络问题不是配置问题。reading choices 报错。这个报错的意思是 OpenClaw 拿到了 API 响应但响应结构里没有choices字段解析失败。常见原因是 Model ID 写错了API 返回了一个错误对象而不是正常的 completion 结构。回控制台确认 Model ID 的准确拼写注意大小写。另一个可能是 Base URL 指向了一个不兼容 OpenAI 格式的端点确认你用的是https://taotoken.net/api。OAuth 相关报错。如果你在配置里误开了 OAuth 模式或者企业微信那边选了需要 OAuth 的连接方式会报这个。OpenClaw 接企业微信机器人用的是 Bot ID Secret 的直连方式不需要 OAuth。检查channels.wecom下面有没有多余的 OAuth 字段删掉。企业微信机器人不回复但日志显示消息已收到。这种情况多半是权限没授权完整。回企业微信 API 配置页确认「可使用权限」里所有项都是已授权状态。如果有一项没授权机器人可能能收消息但无法调用能力返回内容。点「全部授权」一次性搞定。Bot ID 或 Secret 复制不完整。企业微信的 Secret 只显示一次复制时容易漏掉尾部字符。表现是握手失败或鉴权错误。回 API 配置页重新获取一次 Secret完整复制后粘贴到 config.toml注意不要带前后空格。Gateway 不在线。OpenClaw 顶部状态显示离线说明网关没起来。检查端口 8787 是否被其他程序占用用netstat -ano | findstr 8787Windows或lsof -i:8787Linux/macOS看一下。被占用了就改gateway.port换一个端口同时记得改callback_url里的端口号。排障的顺序建议是先 curl 测模型通道再 curl 测网关健康再看 OpenClaw 日志最后看企业微信配置。从下往上排查比一上来就怀疑企业微信要高效得多。6. 接入完成后的自检与后续使用建议链路跑通之后做一遍完整自检确保不是「碰巧通了」企业微信机器人已创建且是 API 模式连接方式选了长连接Bot ID 和 Secret 已完整复制到 config.toml所有可使用权限已全部授权OpenClaw 企业微信插件已安装config.toml 里base_url是https://taotoken.net/apiapi_key有效Model ID 正确Gateway 状态在线企业微信里发消息能收到回复这九条都过了接入就是稳定的。后续使用上几个实用建议。第一把api_key用环境变量管理别硬编码方便轮换。第二timeout根据你的模型和任务类型调整长文本生成建议 180 以上。第三如果团队多人用注意 TaoToken 控制台里的用量避免超额。第四OpenClaw 的日志建议保留一段时间出问题时有据可查。如果你后面想把这个机器人接到更多场景比如自动化工单、群内问答可以在 OpenClaw 的渠道配置里继续加其他渠道模型通道还是共用 TaoToken 这一套不用重复配。需要看更多接入方式的话接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有不同客户端的配置示例。最后提醒一句企业微信机器人的 Secret 泄露等于别人可以冒充你的机器人config.toml 不要随便分享分享前把 Key 和 Secret 都替换成占位符。
