企业微信自建机器人对接 OpenClaw 完整创建、授权、调试步骤（含安装包）｜TaoToken 统一 Key 通道实践

1. 企业微信自建机器人对接 OpenClaw 的场景与链路拆解企业微信自建机器人对接 OpenClaw本质是把企业微信当成一个消息入口把 OpenClaw 当成执行大脑中间靠长连接把两边串起来。你可以在企业微信里发一句“帮我整理今天的会议纪要”消息通过长连接推到本地 OpenClawOpenClaw 调用模型处理完再把结果回传到会话窗口。整个过程不需要公网 IP不需要自己搭反向代理对中小团队和内网环境特别友好。适合谁用三类人最合适一是想把本地自动化脚本接进企业微信的运维或研发二是想给团队做一个内部问答机器人、又不想把数据发到外部平台的技术负责人三是已经在用 OpenClaw 做本地智能体、想扩一个企业微信入口的玩家。核心检索词就是“企业微信自建机器人 OpenClaw 长连接对接”下面所有步骤都围绕它展开。链路可以拆成四段第一段在企业微信后台创建自建应用并拿到 Bot ID 和 Secret第二段在 OpenClaw 侧安装企业微信渠道插件并填入凭证第三段用 TaoToken 统一 Key 通道完成模型鉴权让 OpenClaw 有可调用的模型能力第四段发消息验证收发闭环。很多人卡在第二段和第三段之间因为插件装好了、凭证也填了但模型侧没有可用的 Key机器人收到消息却回不出来。这篇会把这两段都写清楚。先明确一个概念企业微信的“智能机器人”和“自建应用”在权限体系里是两套东西。智能机器人走的是 API 模式 长连接凭证是 Bot ID 和 Secret自建应用走的是 CorpID AgentID Secret。本文聚焦智能机器人这条路径因为长连接方式对本地部署最省事。你如果之前按自建应用那套配过会发现参数对不上这是正常的按下面的步骤重新走一遍即可。OpenClaw 这边需要保持 Gateway 服务在线它是消息进出的总调度。Gateway 掉线时企业微信侧发消息会一直转圈日志里能看到连接断开。所以调试前先确认 Gateway 状态是绿的。另外企业微信客户端要正常登录且当前账号有创建和管理智能机器人的权限普通成员账号在“工作台”里可能看不到“智能机器人”入口。2. TaoToken 统一 Key 通道的前置准备与鉴权配置OpenClaw 本身不绑定某一家模型服务它需要一个兼容 OpenAI 协议的 API 通道来调用模型。TaoToken 在这里扮演的就是统一 Key 通道的角色你拿一个 Key就能在 OpenClaw 里调用多种模型不用为每个模型单独配一套鉴权和地址。对调试阶段特别实用因为你可以先用便宜或快的模型把链路跑通再换成能力更强的模型。前置准备分三块。第一块是 OpenClaw 本体Windows 和 macOS 都有对应部署包装完能正常启动、顶部 Gateway 显示在线即可。第二块是企业微信客户端登录后确认工作台里有“智能机器人”入口。第三块是 TaoToken 的 API Key去控制台创建一个创建时建议按用途命名比如“openclaw-wecom”方便后面排查是哪个 Key 在调用。TaoToken 的接入地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 填进 OpenClaw 的模型配置里。Key 的创建入口在控制台的 API Keys 页面创建后只显示一次复制下来存好。如果你还没创建过可以先打开模型对话页面确认账号状态正常再回来建 Key。这里要强调一个容易踩的坑OpenClaw 的模型配置和渠道配置是两个独立面板。渠道配置填的是企业微信的 Bot ID 和 Secret模型配置填的是 TaoToken 的 Base URL 和 Key。两者都配好机器人才能既收到消息又能回出内容。只配渠道不配模型表现就是机器人“已读不回”只配模型不配渠道表现是企业微信里根本找不到这个机器人。TaoToken 的 Key 在 OpenClaw 里通常填在“模型服务”或“API 配置”区域字段名可能是 API Key 或 Token。Base URL 填https://taotoken.net/apiModel ID 填你要用的模型名比如gpt-4o-mini或claude-3-5-sonnet这类。具体可用模型以控制台模型列表为准。填完先点一次“测试连接”返回成功再继续不要跳过这一步。如果你打算长期跑编码类或 Agent 类任务可以了解下 Coding Plan它在调用额度和模型选择上更适合持续性的自动化场景。调试阶段先用按量计费的 Key 就行跑通后再决定要不要换套餐。文档入口在接入文档页里面有各语言的调用示例OpenClaw 用的是 OpenAI 兼容格式直接参考 curl 示例即可。3. 可复制的企业微信与 OpenClaw 配置片段这一节给可直接复制的配置。先看企业微信侧要采集的参数。进入工作台 → 智能机器人 → 创建机器人场景描述可留空创建后进详情页编辑头像和名称。关键动作是滑到底部点“API 模式创建”连接方式选“长连接”然后点“点击获取”生成 Secret。此时页面上会出现两个值Bot ID 和 Secret。把它们复制到本地临时文件注意不要带前后空格。权限部分点“可使用权限”右上角展开滑到底点“全部授权”确认页面提示“全部授权成功”再回上一级检查所有权限显示“已授权”最后点“保存”。这一步别省权限缺失会导致机器人收不到消息或回不了消息而且报错不明显只表现为“没反应”。OpenClaw 侧的渠道配置进入设置 → 聊天配置 → 企业微信WeCom卡片。如果出现“安装插件”按钮先点安装等它装完。插件是wecom/wecom-openclaw-plugin装完后卡片上会出现 Bot ID 和 Secret 两个输入框。填入后点右上角“保存渠道配置”。模型侧配置用 JSON 形式示意如下路径按 OpenClaw 实际配置文件位置替换{ model_providers: { taotoken: { base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model_id: gpt-4o-mini, api_type: openai } }, default_provider: taotoken }如果你用的是 TOML 格式的配置等价写法[model_providers.taotoken] base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_id gpt-4o-mini api_type openai default_provider taotoken企业微信渠道部分如果 OpenClaw 支持配置文件写入结构大致如下{ channels: { wecom: { enabled: true, bot_id: 你的BotID, secret: 你的Secret, connection_mode: long_connection } } }三件套对照表方便你核对配置项填什么从哪里拿Base URLhttps://taotoken.net/apiTaoToken 固定地址API Keysk-开头字符串TaoToken 控制台 API KeysModel ID如 gpt-4o-miniTaoToken 模型列表Bot ID企业微信生成智能机器人 API 配置页Secret企业微信生成智能机器人 API 配置页连接方式长连接企业微信 API 配置页选择保存后回到企业微信机器人详情页点右上角“去使用”进入对话页发一条“你好”。如果机器人回复了内容说明渠道和模型都通了。如果只显示已读不回优先查模型配置如果消息发出去没反应优先查渠道配置和 Gateway 状态。4. 验证请求与成功结果从发消息到收到回复验证分两步走先验证模型通道再验证企业微信渠道这样出问题时能快速定位是哪一段断了。第一步在 OpenClaw 里找到模型测试功能或者直接用 curl 打 TaoToken 的接口curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复通道正常}] }返回 JSON 里choices[0].message.content有内容说明模型通道没问题。如果返回 401说明 Key 不对或没带上如果返回 404检查 Base URL 是不是写成了带/v1的完整路径TaoToken 的 Base URL 是https://taotoken.net/api具体路径由 OpenClaw 拼接。第二步企业微信侧发消息。进入机器人对话页发送“你好”。成功的结果有三个特征一是消息气泡正常发出没有红色感叹号二是几秒内机器人返回一条文本三是 OpenClaw 日志里能看到一条入站消息和一条出站消息。日志位置一般在 OpenClaw 安装目录的 logs 文件夹或者设置里的日志面板。我试过在 Gateway 刚启动时立刻发消息偶尔会丢第一条等 Gateway 稳定十几秒再发就正常。所以验证时如果第一条没回别急着改配置先等半分钟再发一条。另外企业微信客户端有时会缓存会话状态退出对话页再重新进入能刷新连接。成功跑通后你可以进一步测试多轮对话和指令类任务。比如发“帮我列出当前目录下的文件”OpenClaw 会调用本地能力执行并返回结果。这一步能验证的不只是消息通道还有 OpenClaw 的工具调用链路。如果多轮对话正常但工具调用失败问题在 OpenClaw 的工具配置不在企业微信或 TaoToken。验证清单可以对照着过一遍Gateway 在线、插件已安装、Bot ID 和 Secret 无空格、连接方式为长连接、权限全部授权、渠道配置已保存、TaoToken Key 有效、Model ID 正确、测试消息有回复。九项全过链路就算跑通了。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth调试阶段最常见的四类报错逐个说清楚原因和动作。第一类401 Unauthorized。出现在模型调用阶段说明 TaoToken 的 Key 无效或没带上。检查三处Key 是否复制完整、请求头是否是Authorization: Bearer sk-xxx、Key 是否被删除或过期。如果 OpenClaw 里填了 Key 但日志显示 401试着在控制台重新建一个 Key 替换。注意不要有多余空格复制时容易带上换行。第二类local proxy failed。这个报错通常出现在 OpenClaw 启动或渠道连接阶段意思是本地代理或网络层没起来。先确认 Gateway 是否在线再确认本机网络能正常访问https://taotoken.net/api。如果公司网络有出口限制需要让网络管理员放行该域名。这个报错和企业微信无关是本地到模型通道这一段的问题。第三类reading choices 相关报错完整形态类似cannot read property choices of undefined。这说明请求发出去了但返回结构不是预期的 OpenAI 格式。常见原因是 Base URL 填错比如填成了https://taotoken.net少了/api或者填成了某个具体模型的路径。正确填法是https://taotoken.net/api让 OpenClaw 自己拼/v1/chat/completions。另一个原因是 Model ID 写了一个不存在的模型名返回了错误结构。第四类OAuth 相关报错。企业微信侧如果出现 OAuth 授权失败检查机器人是否选了 API 模式而不是其他模式以及权限是否全部授权。OAuth 报错有时也出现在 OpenClaw 插件安装阶段表现是插件装不上或装完不生效。处理方式是卸载插件重装或者重启 OpenClaw 后再装一次。插件依赖企业微信的开放能力版本不匹配时会报 OAuth 类错误。排查顺序建议固定下来先看 Gateway 状态再看渠道插件再看 Bot ID 和 Secret再看连接方式再看权限授权最后看模型 Key 和 Base URL。按这个顺序走基本能在五分钟内定位到是哪一段的问题。如果全部检查完还是不通重启 OpenClaw 和企业微信客户端再发一条测试消息。6. 长期运行建议与统一 Key 通道的接入入口跑通之后如果你打算长期用有几个点值得注意。第一TaoToken 的 Key 建议按用途分开建企业微信机器人用一个其他自动化任务用另一个这样某个 Key 出问题不影响全部。第二OpenClaw 的 Gateway 建议设成开机自启避免重启电脑后机器人失联。第三企业微信机器人的 Secret 如果泄露去后台重新生成一次然后更新 OpenClaw 渠道配置。模型选择上日常问答用轻量模型就够复杂任务再切到能力更强的模型。TaoToken 的统一 Key 通道好处就在这里换模型只改 Model ID不用动鉴权和地址。如果你要跑持续性的编码或 Agent 任务可以看下 Coding Plan它在长任务场景下更省心。接入过程中需要的几个入口整理如下创建和管理 Key 去 API Keys 页面确认模型可用性去模型对话页面查接入示例去接入文档长期编码任务了解 Coding Plan。企业微信侧的操作都在工作台的智能机器人入口里不需要额外装东西。最后给一个实用技巧把企业微信机器人的对话页固定在客户端左侧调试时不用每次翻工作台。OpenClaw 的日志面板也开着发消息时对照日志看入站和出站记录比猜要快得多。链路跑通只是开始后面你可以把 OpenClaw 的本地工具一个个接进来让企业微信机器人真正变成团队里的自动化助手。