1. 为什么要把 OpenClaw 接进企业微信的会话流企业微信是很多团队每天打开次数最多的办公入口消息、审批、文档、日程都在里面流转。把 AI 助手直接放进这个入口员工不用再切浏览器、不用记某个网页地址在聊天框里 一下机器人就能问制度、查流程、让 AI 帮忙改一段文案这才是「AI 办公」真正落地的样子。OpenClaw 这类工具的价值就在于它把大模型能力包装成一个可被企业微信调用的机器人让 AI 从「另一个要打开的网站」变成「会话流里的一员」。我这次要拆解的是 OpenClaw 与企业微信的完整对接链路从企业微信后台创建 API 长连接机器人到 OpenClaw 端填入 Bot ID 和 Secret再到发一条消息验证「企业微信 → OpenClaw → 大模型 → 返回企业微信」这条闭环。整个过程不需要公网 IP、不需要域名内网环境也能跑通对中小团队特别友好。适合谁看一是想把 AI 助手接进内部沟通工具的技术负责人二是负责企业微信管理后台、需要配置机器人的运维或行政同学三是想自己动手跑通一条 AI 消息链路的开发者。读完你应该能独立完成一次对接并知道出错时去哪里查。需要先说明一点OpenClaw 负责的是「渠道接入 消息路由」它本身要调用大模型才能产生回复。模型这一层我用的是 TaoToken 的 API它提供兼容 OpenAI 风格的接口把 Base URL、API Key、Model ID 三件套填进 OpenClaw 的模型配置里就能用。下面会先讲企业微信侧再讲 OpenClaw 侧最后讲模型侧和验证。2. 企业微信侧准备创建 API 长连接机器人这一步的目标是拿到两个凭证Bot ID 和 Secret。它们是 OpenClaw 连接企业微信的钥匙后面配置要用。先登录企业微信管理后台用企业管理员账号进入「工作台」→「智能机器人」点「创建机器人」选择「手动创建」。进入创建页面后关键的一步是选择创建模式页面会提示「如需使用自有系统获取成员与机器人的聊天并输出回复可切换至 API 模式创建」我们选 API 模式。在 API 配置页连接方式选「使用长连接」。这里解释一下为什么选长连接而不是 URL 回调URL 回调方式需要企业微信能主动访问到你的服务器也就是要有公网可访问的地址而长连接方式是 OpenClaw 主动向企业微信建立并保持一条连接消息通过这条连接双向流动所以不需要公网 IP 和域名本地部署、内网环境都能用。这也是对接 OpenClaw 的推荐方式。配置完成后页面会自动生成并展示 Bot ID 和 Secret。这两个值只在这里展示务必先复制保存好关掉页面后 Secret 通常不再完整显示。接着补充机器人的可见范围也就是哪些部门或成员能用这个机器人其余项保持默认即可。API 模式暂不支持预览与调试直接保存机器人配置。保存后回到「智能机器人」列表确认机器人状态正常、渠道已启用。到这里企业微信侧就准备好了你手里应该有两串字符Bot ID 和 Secret。如果后面 OpenClaw 连不上第一件事就是回来核对这两个值有没有复制错、有没有多余空格。注意Secret 属于敏感凭证不要贴到公开的聊天群或代码仓库里。团队协作时建议放在密码管理工具中传递。3. OpenClaw 侧配置填入凭证并启用渠道打开 OpenClaw 客户端先确认 Gateway 处于在线状态。Gateway 是 OpenClaw 的消息网关负责接收企业微信推来的消息、调用模型、再把回复送回去它不在线后面所有步骤都白搭。在渠道配置里选择「企业微信 (WeCom)」然后依次填入上一步拿到的 Bot ID 和 Secret。填完点右上角「保存」再确认该渠道已启用最后重启网关让配置生效。重启这一步别省很多「填了没反应」的情况就是没重启。接下来是模型配置这是让机器人真正能「说话」的关键。OpenClaw 需要知道调用哪个大模型、用哪个地址、带哪个 Key。我用的是 TaoToken 的接口它兼容 OpenAI 风格配置上就是三件套Base URL、API Key、Model ID。先到 TaoToken 控制台创建一个 API Key访问 https://taotoken.net/api-keys 登录后新建一个 Key 并复制保存。然后在 OpenClaw 的模型配置里填入{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5, temperature: 0.7, max_tokens: 2048 }几个字段说明一下。base_url填https://taotoken.net/api注意不要多加/v1之类的后缀具体以接入文档为准api_key就是你刚创建的 Keymodel填你要用的模型 ID比如claude-sonnet-4-5具体可用模型可以在模型对话页面试。temperature控制回复的发散程度办公问答场景 0.5 到 0.7 比较稳max_tokens限制单次回复长度按需调整。如果你用的是带图形界面的 OpenClaw 版本这些字段会对应到界面上的输入框填法一致。保存后同样重启一次网关让模型配置和渠道配置一起生效。提示Base URL、API Key、Model ID 这三件套要成套出现缺一个都会导致调用失败。排障时先确认这三个值都填了、都填对了。4. 验证一条消息的完整链路配置完成后最激动人心的就是发一条消息看它能不能回来。这一步要验证的是完整闭环企业微信 → OpenClaw Gateway → 大模型 → OpenClaw → 企业微信。打开企业微信客户端进入「工作台」→「智能机器人」找到你刚创建的机器人发起会话。先发一句简单的「你好帮我写一句周会开场白。」发送后观察几秒。正常情况下你会看到机器人先显示「正在输入」之类的状态然后返回一段开场白文案。这说明消息已经走通了企业微信把消息通过长连接推给 OpenClawOpenClaw 调用 TaoToken 的模型接口拿到回复再把回复送回企业微信。如果没反应先看 OpenClaw 的日志面板。日志里通常能看到消息是否收到、模型请求是否发出、返回了什么。常见的成功日志会显示收到一条 WeCom 消息、发起一次模型请求、收到 200 响应。如果日志里连「收到消息」都没有问题在企业微信到 OpenClaw 这一段如果有收到消息但没有模型请求问题在模型配置如果有模型请求但报错看错误码。想单独验证模型这一层是否正常可以到模型对话页面直接发一句话测试确认 Key 和模型 ID 没问题再回到企业微信里测。这样能把「渠道问题」和「模型问题」分开定位。实测下来一条消息从发出到收到回复延迟主要取决于模型推理时间通常在几秒内。如果明显超过十几秒还没回先检查网络和模型服务状态。5. 常见报错与排查对照对接过程中最容易卡在几个固定位置下面按真实报错对照排查。401 Unauthorized / invalid api key模型调用被拒。原因通常是 API Key 填错、复制时带了空格、或者 Key 已失效。解决方法是回到 TaoToken 控制台重新创建一个 Key替换后重启网关。注意 Base URL 和 Key 要配套别把别处的 Key 填进来。local proxy failed / connection refusedOpenClaw 连不上模型服务。先确认base_url填的是https://taotoken.net/api没有多余路径再确认本机网络能正常访问外网。如果公司网络有出口限制需要让运维放行对应域名。reading choices / 返回结构解析失败这类报错通常出现在模型返回格式和 OpenClaw 预期不一致时。检查provider是否设为openai-compatiblemodel是否是有效的模型 ID。模型 ID 写错有时不会立刻报错而是返回一个空结构导致解析失败。OAuth / 授权相关报错如果 OpenClaw 里配置了需要 OAuth 的模型提供方而凭证过期会出现这类提示。办公场景建议直接用 API Key 方式少一层授权环节排障更简单。企业微信侧收不到回复但 OpenClaw 日志显示已发送检查机器人的可见范围是否包含当前成员以及渠道是否真的启用了。有时候配置保存了但没重启网关渠道实际没生效。消息重复回复多半是同时启用了长连接和 URL 回调两种方式或者配置了多个渠道实例。保留一种连接方式即可。排查顺序建议固定成一条线先看企业微信机器人状态再看 OpenClaw 渠道是否启用再看模型三件套最后看日志里的具体错误码。按这个顺序走大部分问题五分钟内能定位。6. 把 AI 助手真正用起来跑通之后这个机器人能做的事情取决于你怎么用它。办公场景里比较实用的几类制度问答把员工手册、报销流程喂给模型做知识库员工在群里直接问文案辅助让 AI 帮忙改通知、写周报、润色邮件消息自动化配合 OpenClaw 的主动推送能力把系统告警、审批提醒推到指定会话。如果团队要长期用、还要接更多渠道钉钉、飞书或者做 Agent 编排建议用 Coding Plan 这类长期方案来管理模型调用比每次临时配 Key 更省心。想先体验模型效果可以直接到模型对话页面发几句话感受一下不同模型的风格差异。接入过程中遇到配置细节问题接入文档里有更完整的字段说明。最后留一个实用技巧把 Bot ID、Secret、Base URL、API Key、Model ID 这五个值整理成一张配置清单存在团队文档里Secret 和 Key 注意权限下次换机器或重装 OpenClaw 时直接照着填能省掉大量重复排查的时间。 
长河君 · 2026/10/4 13:32:57 · 阅读 1.2k OpenClaw 落地企业微信：把 AI 办公助手接进日常会话流
1. 为什么要把 OpenClaw 接进企业微信的会话流企业微信是很多团队每天打开次数最多的办公入口消息、审批、文档、日程都在里面流转。把 AI 助手直接放进这个入口员工不用再切浏览器、不用记某个网页地址在聊天框里 一下机器人就能问制度、查流程、让 AI 帮忙改一段文案这才是「AI 办公」真正落地的样子。OpenClaw 这类工具的价值就在于它把大模型能力包装成一个可被企业微信调用的机器人让 AI 从「另一个要打开的网站」变成「会话流里的一员」。我这次要拆解的是 OpenClaw 与企业微信的完整对接链路从企业微信后台创建 API 长连接机器人到 OpenClaw 端填入 Bot ID 和 Secret再到发一条消息验证「企业微信 → OpenClaw → 大模型 → 返回企业微信」这条闭环。整个过程不需要公网 IP、不需要域名内网环境也能跑通对中小团队特别友好。适合谁看一是想把 AI 助手接进内部沟通工具的技术负责人二是负责企业微信管理后台、需要配置机器人的运维或行政同学三是想自己动手跑通一条 AI 消息链路的开发者。读完你应该能独立完成一次对接并知道出错时去哪里查。需要先说明一点OpenClaw 负责的是「渠道接入 消息路由」它本身要调用大模型才能产生回复。模型这一层我用的是 TaoToken 的 API它提供兼容 OpenAI 风格的接口把 Base URL、API Key、Model ID 三件套填进 OpenClaw 的模型配置里就能用。下面会先讲企业微信侧再讲 OpenClaw 侧最后讲模型侧和验证。2. 企业微信侧准备创建 API 长连接机器人这一步的目标是拿到两个凭证Bot ID 和 Secret。它们是 OpenClaw 连接企业微信的钥匙后面配置要用。先登录企业微信管理后台用企业管理员账号进入「工作台」→「智能机器人」点「创建机器人」选择「手动创建」。进入创建页面后关键的一步是选择创建模式页面会提示「如需使用自有系统获取成员与机器人的聊天并输出回复可切换至 API 模式创建」我们选 API 模式。在 API 配置页连接方式选「使用长连接」。这里解释一下为什么选长连接而不是 URL 回调URL 回调方式需要企业微信能主动访问到你的服务器也就是要有公网可访问的地址而长连接方式是 OpenClaw 主动向企业微信建立并保持一条连接消息通过这条连接双向流动所以不需要公网 IP 和域名本地部署、内网环境都能用。这也是对接 OpenClaw 的推荐方式。配置完成后页面会自动生成并展示 Bot ID 和 Secret。这两个值只在这里展示务必先复制保存好关掉页面后 Secret 通常不再完整显示。接着补充机器人的可见范围也就是哪些部门或成员能用这个机器人其余项保持默认即可。API 模式暂不支持预览与调试直接保存机器人配置。保存后回到「智能机器人」列表确认机器人状态正常、渠道已启用。到这里企业微信侧就准备好了你手里应该有两串字符Bot ID 和 Secret。如果后面 OpenClaw 连不上第一件事就是回来核对这两个值有没有复制错、有没有多余空格。注意Secret 属于敏感凭证不要贴到公开的聊天群或代码仓库里。团队协作时建议放在密码管理工具中传递。3. OpenClaw 侧配置填入凭证并启用渠道打开 OpenClaw 客户端先确认 Gateway 处于在线状态。Gateway 是 OpenClaw 的消息网关负责接收企业微信推来的消息、调用模型、再把回复送回去它不在线后面所有步骤都白搭。在渠道配置里选择「企业微信 (WeCom)」然后依次填入上一步拿到的 Bot ID 和 Secret。填完点右上角「保存」再确认该渠道已启用最后重启网关让配置生效。重启这一步别省很多「填了没反应」的情况就是没重启。接下来是模型配置这是让机器人真正能「说话」的关键。OpenClaw 需要知道调用哪个大模型、用哪个地址、带哪个 Key。我用的是 TaoToken 的接口它兼容 OpenAI 风格配置上就是三件套Base URL、API Key、Model ID。先到 TaoToken 控制台创建一个 API Key访问 https://taotoken.net/api-keys 登录后新建一个 Key 并复制保存。然后在 OpenClaw 的模型配置里填入{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5, temperature: 0.7, max_tokens: 2048 }几个字段说明一下。base_url填https://taotoken.net/api注意不要多加/v1之类的后缀具体以接入文档为准api_key就是你刚创建的 Keymodel填你要用的模型 ID比如claude-sonnet-4-5具体可用模型可以在模型对话页面试。temperature控制回复的发散程度办公问答场景 0.5 到 0.7 比较稳max_tokens限制单次回复长度按需调整。如果你用的是带图形界面的 OpenClaw 版本这些字段会对应到界面上的输入框填法一致。保存后同样重启一次网关让模型配置和渠道配置一起生效。提示Base URL、API Key、Model ID 这三件套要成套出现缺一个都会导致调用失败。排障时先确认这三个值都填了、都填对了。4. 验证一条消息的完整链路配置完成后最激动人心的就是发一条消息看它能不能回来。这一步要验证的是完整闭环企业微信 → OpenClaw Gateway → 大模型 → OpenClaw → 企业微信。打开企业微信客户端进入「工作台」→「智能机器人」找到你刚创建的机器人发起会话。先发一句简单的「你好帮我写一句周会开场白。」发送后观察几秒。正常情况下你会看到机器人先显示「正在输入」之类的状态然后返回一段开场白文案。这说明消息已经走通了企业微信把消息通过长连接推给 OpenClawOpenClaw 调用 TaoToken 的模型接口拿到回复再把回复送回企业微信。如果没反应先看 OpenClaw 的日志面板。日志里通常能看到消息是否收到、模型请求是否发出、返回了什么。常见的成功日志会显示收到一条 WeCom 消息、发起一次模型请求、收到 200 响应。如果日志里连「收到消息」都没有问题在企业微信到 OpenClaw 这一段如果有收到消息但没有模型请求问题在模型配置如果有模型请求但报错看错误码。想单独验证模型这一层是否正常可以到模型对话页面直接发一句话测试确认 Key 和模型 ID 没问题再回到企业微信里测。这样能把「渠道问题」和「模型问题」分开定位。实测下来一条消息从发出到收到回复延迟主要取决于模型推理时间通常在几秒内。如果明显超过十几秒还没回先检查网络和模型服务状态。5. 常见报错与排查对照对接过程中最容易卡在几个固定位置下面按真实报错对照排查。401 Unauthorized / invalid api key模型调用被拒。原因通常是 API Key 填错、复制时带了空格、或者 Key 已失效。解决方法是回到 TaoToken 控制台重新创建一个 Key替换后重启网关。注意 Base URL 和 Key 要配套别把别处的 Key 填进来。local proxy failed / connection refusedOpenClaw 连不上模型服务。先确认base_url填的是https://taotoken.net/api没有多余路径再确认本机网络能正常访问外网。如果公司网络有出口限制需要让运维放行对应域名。reading choices / 返回结构解析失败这类报错通常出现在模型返回格式和 OpenClaw 预期不一致时。检查provider是否设为openai-compatiblemodel是否是有效的模型 ID。模型 ID 写错有时不会立刻报错而是返回一个空结构导致解析失败。OAuth / 授权相关报错如果 OpenClaw 里配置了需要 OAuth 的模型提供方而凭证过期会出现这类提示。办公场景建议直接用 API Key 方式少一层授权环节排障更简单。企业微信侧收不到回复但 OpenClaw 日志显示已发送检查机器人的可见范围是否包含当前成员以及渠道是否真的启用了。有时候配置保存了但没重启网关渠道实际没生效。消息重复回复多半是同时启用了长连接和 URL 回调两种方式或者配置了多个渠道实例。保留一种连接方式即可。排查顺序建议固定成一条线先看企业微信机器人状态再看 OpenClaw 渠道是否启用再看模型三件套最后看日志里的具体错误码。按这个顺序走大部分问题五分钟内能定位。6. 把 AI 助手真正用起来跑通之后这个机器人能做的事情取决于你怎么用它。办公场景里比较实用的几类制度问答把员工手册、报销流程喂给模型做知识库员工在群里直接问文案辅助让 AI 帮忙改通知、写周报、润色邮件消息自动化配合 OpenClaw 的主动推送能力把系统告警、审批提醒推到指定会话。如果团队要长期用、还要接更多渠道钉钉、飞书或者做 Agent 编排建议用 Coding Plan 这类长期方案来管理模型调用比每次临时配 Key 更省心。想先体验模型效果可以直接到模型对话页面发几句话感受一下不同模型的风格差异。接入过程中遇到配置细节问题接入文档里有更完整的字段说明。最后留一个实用技巧把 Bot ID、Secret、Base URL、API Key、Model ID 这五个值整理成一张配置清单存在团队文档里Secret 和 Key 注意权限下次换机器或重装 OpenClaw 时直接照着填能省掉大量重复排查的时间。