1. 为什么企业微信渠道值得单独配一遍OpenClaw 接入企业微信这件事真正卡人的地方从来不是点哪个按钮而是三个东西凑不齐机器人侧要拿到 Bot ID 和 Secret连接方式要选长连接权限要一次性授权完整。少任何一环表现都是配置看起来保存成功了但机器人不回消息。我见过太多人卡在最后一步企业微信里发你好机器人一动不动然后开始怀疑是不是 OpenClaw 坏了。其实九成情况是权限没授全或者 Secret 复制时带了个空格。这篇教程聚焦 OpenClaw 企业微信渠道的 API 模式 长连接配置把全部授权流程走完最后交付一份可以直接抄的config.toml骨架以及用 TaoToken 统一 Key 接入模型侧的配置。适合两类人一是第一次给 OpenClaw 接企业微信、想要一份能照着做到底的清单二是已经接了但机器人不回复、想按排查顺序定位问题的人。整篇的节奏是先把企业微信机器人侧参数拿到手再回到 OpenClaw 填渠道配置然后配模型 Key最后发消息验证。每一步都给可复制的命令或配置不玩自行理解。2. 前置准备企业微信机器人参数与 TaoToken Key2.1 企业微信侧要拿到什么在动手改 OpenClaw 之前先把企业微信这边的三样东西确认好第一当前企业微信账号要有创建和管理智能机器人的权限。没有这个权限工作台里根本看不到智能机器人入口。第二机器人必须走API 模式创建而不是普通模式。普通模式拿不到 Bot ID 和 Secret后面 OpenClaw 就没法填。第三连接方式选使用长连接。长连接的好处是不需要你暴露公网回调地址OpenClaw 主动和企业微信保持通道内网环境也能跑通。操作路径大致是企业微信客户端 → 工作台 → 智能机器人 → 创建机器人 → 填名称头像简介 → 滚到底部点API 模式创建 → 连接方式选使用长连接 → 点点击获取拿到 Secret → 展开权限列表 → 滚到底部点全部授权 → 看到全部授权成功提示 → 返回保存 → 进API 配置复制 Bot ID 和 Secret。这里有个容易忽略的点全部授权按钮在权限弹窗的最底部很多人滚到一半以为看完了就返回结果权限只授了一部分。授权不完整最典型的症状就是机器人能收到消息但不回复因为缺少调用能力或读取消息的权限。2.2 TaoToken 侧要准备什么OpenClaw 本身是渠道框架真正生成回复内容要靠背后的模型。这里用 TaoToken 做统一 Key 接入好处是一个 Key 管多个模型切换模型不用改一堆环境变量。先去控制台建一个 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channelAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel建好之后把 Key 复制出来格式通常是一串以sk-开头的字符串。这个 Key 后面要写进 OpenClaw 的模型配置里。API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 用。提示Key 只显示一次复制后先存到本地密码管理器或临时文件里别直接贴在聊天窗口。3. 可复制配置config.toml 骨架与渠道填写3.1 OpenClaw 企业微信渠道填写回到 OpenClaw点右上角设置 → 左侧聊天配置 → 找到企业微信WeCom。如果这里显示安装插件先点安装。企业微信接入依赖插件wecom/wecom-openclaw-plugin没装插件的话下面的 Bot ID 和 Secret 输入框填了也不生效。插件装完后把企业微信 API 配置页复制的两个值填进去Bot ID企业微信机器人 API 配置页里的 Bot IDSecret同一页面里的 Secret填完点右上角保存渠道配置。这一步保存的是渠道凭证和后面的模型配置是两回事别混在一起。3.2 config.toml 骨架OpenClaw 的配置文件一般放在用户目录下的.openclaw/config.tomlWindows 是%USERPROFILE%\.openclaw\config.toml。下面是一份可以直接改的骨架渠道部分和模型部分分开写# OpenClaw 主配置骨架 # 渠道企业微信长连接模式 [channels.wecom] enabled true bot_id 你的BotID secret 你的Secret connection_mode long_connection # 长连接无需公网回调 plugin wecom/wecom-openclaw-plugin # 模型TaoToken 统一 Key 接入 [models.default] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-5 timeout 60 # 网关 [gateway] listen 127.0.0.1:8787 log_level info几个参数说明参数作用注意connection_mode连接方式必须和企微侧一致选长连接plugin渠道插件名拼写要和安装时一致base_url模型 API 地址用https://taotoken.net/api不带参数api_key模型鉴权填 TaoToken 控制台建的 Keymodel默认模型按需换成你要用的模型名如果你更习惯用环境变量而不是写死在 toml 里可以把 Key 抽出来# Linux / macOS export TAOTOKEN_API_KEYsk-你的TaoTokenKey # Windows PowerShell $env:TAOTOKEN_API_KEYsk-你的TaoTokenKey然后在 toml 里写api_key ${TAOTOKEN_API_KEY}。这样换 Key 不用动配置文件也避免 Key 进版本库。3.3 长连接模式的关键点长连接模式下OpenClaw 启动后会主动向企业微信建立并维持一条通道。你不需要在企微后台配回调 URL也不需要公网 IP。代价是这条连接要保持活跃如果 OpenClaw 进程挂了或者网络断了通道就断机器人自然不回消息。所以配置完之后第一件事是确认 OpenClaw 顶部的 Gateway 状态是在线的。Gateway 不在线后面所有验证都是白搭。4. 验证请求从发消息到确认回复4.1 先验证模型侧通不通在验证企业微信之前先单独确认 TaoToken 这条链路是通的。用 curl 打一个最小请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字收到}] }如果返回里有正常的choices内容说明 Key 和 base_url 都没问题。这一步能过后面企业微信不回消息就基本可以排除模型侧的原因。想先在网页里直观试一下模型效果可以用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel4.2 再验证企业微信渠道模型通了之后回到企业微信机器人详情页点右上角去使用进入机器人聊天窗口发一条测试消息比如你好。正常情况机器人会返回内容。如果返回了说明整条链路——企业微信 → 长连接 → OpenClaw → TaoToken → 模型——全部打通。4.3 授权范围核对清单发消息之前建议对着这份清单逐项打勾避免配了但不回企业微信里已成功创建智能机器人创建时走的是 API 模式连接方式选的是使用长连接Bot ID 和 Secret 已复制且无多余空格权限列表已滚到底部点全部授权页面出现过全部授权成功提示OpenClaw 里企业微信插件已安装完成Bot ID 和 Secret 已正确粘贴并保存渠道配置OpenClaw 顶部 Gateway 状态在线已向机器人发送测试消息并收到回复这份清单的价值在于出问题时你不用瞎猜从上往下逐项排除就行。5. 本篇常见错排查5.1 机器人不回复按这个顺序查第一看 OpenClaw 顶部 Gateway 是否在线。不在线先解决 Gateway别往下查。第二确认企业微信插件装完了。插件没装渠道配置保存了也是空转。第三检查 Bot ID 和 Secret 有没有复制完整。Secret 经常在复制时带上首尾空格肉眼看不出来粘到输入框里就会鉴权失败。建议粘完后手动检查一遍首尾。第四回企业微信 API 配置页确认连接方式确实是使用长连接不是别的模式。第五确认权限是全部授权而不是部分授权。部分授权时机器人可能能收到消息但无法调用能力表现就是不回复。第六确认点过保存渠道配置。有人填完参数直接关窗口没保存。以上都排完还不回复重启一次 OpenClaw 再测。重启会重新建立长连接能解决一部分通道僵死的情况。5.2 模型侧报错怎么定位如果企业微信能收到消息但返回的是错误提示问题多半在模型配置。常见两类一是401或鉴权失败检查api_key是不是复制错了或者环境变量没生效。用 4.1 的 curl 单独测一次就能定位。二是model not found说明model字段写的模型名不对。换成你账号下确实可用的模型名再试。5.3 长连接频繁掉线长连接掉线通常和网络稳定性有关。如果 OpenClaw 跑在会休眠的机器上或者网络经常切换通道就容易断。可以考虑把 OpenClaw 放在常开的机器上或者加一个进程守护挂了自动拉起。6. 后续把 Key 和渠道管起来渠道配通只是第一步。真正长期用起来你会遇到两个需求一是换模型不想改配置二是多个渠道共用一套 Key。TaoToken 的统一 Key 正好解决这两点。一个 Key 可以调不同模型OpenClaw 里只改model字段就行base_url和api_key不用动。如果你还要接别的渠道也可以复用同一个 Key省得每个渠道单独维护一套凭证。Key 的管理入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel接入相关的文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel如果你打算把 OpenClaw 用在长期编码或 Agent 场景频繁调用模型可以看一下 Coding Plan额度模型更适合这种持续跑的场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel最后给一个实操建议把config.toml里的 Key 换成环境变量引用然后给这份配置做个备份。企业微信的 Secret 如果哪天重置了你只需要改渠道那两行模型配置完全不用动。这样下次再遇到机器人不回复排查范围能直接缩小一半。
1. 为什么企业微信渠道值得单独配一遍OpenClaw 接入企业微信这件事真正卡人的地方从来不是点哪个按钮而是三个东西凑不齐机器人侧要拿到 Bot ID 和 Secret连接方式要选长连接权限要一次性授权完整。少任何一环表现都是配置看起来保存成功了但机器人不回消息。我见过太多人卡在最后一步企业微信里发你好机器人一动不动然后开始怀疑是不是 OpenClaw 坏了。其实九成情况是权限没授全或者 Secret 复制时带了个空格。这篇教程聚焦 OpenClaw 企业微信渠道的 API 模式 长连接配置把全部授权流程走完最后交付一份可以直接抄的config.toml骨架以及用 TaoToken 统一 Key 接入模型侧的配置。适合两类人一是第一次给 OpenClaw 接企业微信、想要一份能照着做到底的清单二是已经接了但机器人不回复、想按排查顺序定位问题的人。整篇的节奏是先把企业微信机器人侧参数拿到手再回到 OpenClaw 填渠道配置然后配模型 Key最后发消息验证。每一步都给可复制的命令或配置不玩自行理解。2. 前置准备企业微信机器人参数与 TaoToken Key2.1 企业微信侧要拿到什么在动手改 OpenClaw 之前先把企业微信这边的三样东西确认好第一当前企业微信账号要有创建和管理智能机器人的权限。没有这个权限工作台里根本看不到智能机器人入口。第二机器人必须走API 模式创建而不是普通模式。普通模式拿不到 Bot ID 和 Secret后面 OpenClaw 就没法填。第三连接方式选使用长连接。长连接的好处是不需要你暴露公网回调地址OpenClaw 主动和企业微信保持通道内网环境也能跑通。操作路径大致是企业微信客户端 → 工作台 → 智能机器人 → 创建机器人 → 填名称头像简介 → 滚到底部点API 模式创建 → 连接方式选使用长连接 → 点点击获取拿到 Secret → 展开权限列表 → 滚到底部点全部授权 → 看到全部授权成功提示 → 返回保存 → 进API 配置复制 Bot ID 和 Secret。这里有个容易忽略的点全部授权按钮在权限弹窗的最底部很多人滚到一半以为看完了就返回结果权限只授了一部分。授权不完整最典型的症状就是机器人能收到消息但不回复因为缺少调用能力或读取消息的权限。2.2 TaoToken 侧要准备什么OpenClaw 本身是渠道框架真正生成回复内容要靠背后的模型。这里用 TaoToken 做统一 Key 接入好处是一个 Key 管多个模型切换模型不用改一堆环境变量。先去控制台建一个 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channelAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel建好之后把 Key 复制出来格式通常是一串以sk-开头的字符串。这个 Key 后面要写进 OpenClaw 的模型配置里。API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 用。提示Key 只显示一次复制后先存到本地密码管理器或临时文件里别直接贴在聊天窗口。3. 可复制配置config.toml 骨架与渠道填写3.1 OpenClaw 企业微信渠道填写回到 OpenClaw点右上角设置 → 左侧聊天配置 → 找到企业微信WeCom。如果这里显示安装插件先点安装。企业微信接入依赖插件wecom/wecom-openclaw-plugin没装插件的话下面的 Bot ID 和 Secret 输入框填了也不生效。插件装完后把企业微信 API 配置页复制的两个值填进去Bot ID企业微信机器人 API 配置页里的 Bot IDSecret同一页面里的 Secret填完点右上角保存渠道配置。这一步保存的是渠道凭证和后面的模型配置是两回事别混在一起。3.2 config.toml 骨架OpenClaw 的配置文件一般放在用户目录下的.openclaw/config.tomlWindows 是%USERPROFILE%\.openclaw\config.toml。下面是一份可以直接改的骨架渠道部分和模型部分分开写# OpenClaw 主配置骨架 # 渠道企业微信长连接模式 [channels.wecom] enabled true bot_id 你的BotID secret 你的Secret connection_mode long_connection # 长连接无需公网回调 plugin wecom/wecom-openclaw-plugin # 模型TaoToken 统一 Key 接入 [models.default] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-5 timeout 60 # 网关 [gateway] listen 127.0.0.1:8787 log_level info几个参数说明参数作用注意connection_mode连接方式必须和企微侧一致选长连接plugin渠道插件名拼写要和安装时一致base_url模型 API 地址用https://taotoken.net/api不带参数api_key模型鉴权填 TaoToken 控制台建的 Keymodel默认模型按需换成你要用的模型名如果你更习惯用环境变量而不是写死在 toml 里可以把 Key 抽出来# Linux / macOS export TAOTOKEN_API_KEYsk-你的TaoTokenKey # Windows PowerShell $env:TAOTOKEN_API_KEYsk-你的TaoTokenKey然后在 toml 里写api_key ${TAOTOKEN_API_KEY}。这样换 Key 不用动配置文件也避免 Key 进版本库。3.3 长连接模式的关键点长连接模式下OpenClaw 启动后会主动向企业微信建立并维持一条通道。你不需要在企微后台配回调 URL也不需要公网 IP。代价是这条连接要保持活跃如果 OpenClaw 进程挂了或者网络断了通道就断机器人自然不回消息。所以配置完之后第一件事是确认 OpenClaw 顶部的 Gateway 状态是在线的。Gateway 不在线后面所有验证都是白搭。4. 验证请求从发消息到确认回复4.1 先验证模型侧通不通在验证企业微信之前先单独确认 TaoToken 这条链路是通的。用 curl 打一个最小请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字收到}] }如果返回里有正常的choices内容说明 Key 和 base_url 都没问题。这一步能过后面企业微信不回消息就基本可以排除模型侧的原因。想先在网页里直观试一下模型效果可以用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel4.2 再验证企业微信渠道模型通了之后回到企业微信机器人详情页点右上角去使用进入机器人聊天窗口发一条测试消息比如你好。正常情况机器人会返回内容。如果返回了说明整条链路——企业微信 → 长连接 → OpenClaw → TaoToken → 模型——全部打通。4.3 授权范围核对清单发消息之前建议对着这份清单逐项打勾避免配了但不回企业微信里已成功创建智能机器人创建时走的是 API 模式连接方式选的是使用长连接Bot ID 和 Secret 已复制且无多余空格权限列表已滚到底部点全部授权页面出现过全部授权成功提示OpenClaw 里企业微信插件已安装完成Bot ID 和 Secret 已正确粘贴并保存渠道配置OpenClaw 顶部 Gateway 状态在线已向机器人发送测试消息并收到回复这份清单的价值在于出问题时你不用瞎猜从上往下逐项排除就行。5. 本篇常见错排查5.1 机器人不回复按这个顺序查第一看 OpenClaw 顶部 Gateway 是否在线。不在线先解决 Gateway别往下查。第二确认企业微信插件装完了。插件没装渠道配置保存了也是空转。第三检查 Bot ID 和 Secret 有没有复制完整。Secret 经常在复制时带上首尾空格肉眼看不出来粘到输入框里就会鉴权失败。建议粘完后手动检查一遍首尾。第四回企业微信 API 配置页确认连接方式确实是使用长连接不是别的模式。第五确认权限是全部授权而不是部分授权。部分授权时机器人可能能收到消息但无法调用能力表现就是不回复。第六确认点过保存渠道配置。有人填完参数直接关窗口没保存。以上都排完还不回复重启一次 OpenClaw 再测。重启会重新建立长连接能解决一部分通道僵死的情况。5.2 模型侧报错怎么定位如果企业微信能收到消息但返回的是错误提示问题多半在模型配置。常见两类一是401或鉴权失败检查api_key是不是复制错了或者环境变量没生效。用 4.1 的 curl 单独测一次就能定位。二是model not found说明model字段写的模型名不对。换成你账号下确实可用的模型名再试。5.3 长连接频繁掉线长连接掉线通常和网络稳定性有关。如果 OpenClaw 跑在会休眠的机器上或者网络经常切换通道就容易断。可以考虑把 OpenClaw 放在常开的机器上或者加一个进程守护挂了自动拉起。6. 后续把 Key 和渠道管起来渠道配通只是第一步。真正长期用起来你会遇到两个需求一是换模型不想改配置二是多个渠道共用一套 Key。TaoToken 的统一 Key 正好解决这两点。一个 Key 可以调不同模型OpenClaw 里只改model字段就行base_url和api_key不用动。如果你还要接别的渠道也可以复用同一个 Key省得每个渠道单独维护一套凭证。Key 的管理入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel接入相关的文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel如果你打算把 OpenClaw 用在长期编码或 Agent 场景频繁调用模型可以看一下 Coding Plan额度模型更适合这种持续跑的场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentwecom_channel最后给一个实操建议把config.toml里的 Key 换成环境变量引用然后给这份配置做个备份。企业微信的 Secret 如果哪天重置了你只需要改渠道那两行模型配置完全不用动。这样下次再遇到机器人不回复排查范围能直接缩小一半。
