1. 从零理解 OpenClaw 接入企业微信智能机器人的长连接方案企业微信智能机器人最近开放了长连接接入能力这件事对做内部工具和自动化流程的人来说意义不小。过去想把 OpenClaw 这类 Agent 框架接到企业微信基本只能走 URL 回调你得有一台公网可达的服务器、配好 HTTPS 证书、处理消息加解密还要担心回调地址被防火墙拦掉。现在长连接模式把这条链路反过来了——由 OpenClaw 主动向企业微信建立并维持一条 WebSocket 通道消息通过这条通道双向流动你不再需要暴露任何公网端口。先把几个概念说清楚不然后面配置容易懵。OpenClaw 是一个可以本地或云端部署的 Agent 运行框架它通过「插件 渠道」的方式对接外部 IM。企业微信这边智能机器人是工作台里的一个应用形态创建时可以选择「API 模式」API 模式里又分 URL 回调和长连接两种。长连接模式会给你两个关键凭证Bot ID 和 Secret。Bot ID 相当于机器人的身份证号Secret 相当于它的密码OpenClaw 拿这两个值去企业微信换一条长连接通道。长连接相比 URL 回调有三个实际好处。第一不需要公网 IP 和域名本地笔记本、内网服务器都能跑。第二支持被动回复多条消息用户问一句机器人可以分几条陆续回适合 Agent 边思考边输出的场景。第三支持主动推送机器人可以在没有用户触发的情况下往会话里发消息做定时提醒、告警通知很顺手。适合谁看这篇如果你正在用 OpenClaw 做内部知识库问答、工单助手、数据查询机器人并且团队日常沟通在企业微信里那这套方案基本就是为你准备的。下面我会按「拿 Bot ID → 装插件 → 写配置 → 验证连通 → 排错」的顺序走一遍配置片段可以直接复制。2. TaoToken 前置准备模型通道与 OpenClaw 的关系在动手接企业微信之前得先保证 OpenClaw 本身能正常跑起来、能调通模型。OpenClaw 只是个调度框架真正干活的是背后的大模型。如果你还没配模型通道机器人接上了也只会回你一句「模型不可用」。我这边习惯用 TaoToken 作为模型接入层原因是它同时提供 OpenAI 兼容接口和 Anthropic 兼容接口OpenClaw 里切换模型不用改代码改配置就行。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意 API 地址后面不带查询参数。你需要先拿到一个 API Key。登录后进控制台在 API Keys 页面创建一个复制出来存好。这个 Key 后面要写进 OpenClaw 的模型配置里。如果你打算长期跑编码类 Agent可以顺带看下 Coding Plan额度模型和按量计费不太一样适合高频调用场景。模型配置这块OpenClaw 的配置文件通常放在~/.openclaw/config.toml本地部署或者 Lighthouse 实例的应用管理页里。核心是填三样东西Base URL、API Key、Model ID。以 OpenAI 兼容格式为例配置片段长这样[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id claude-sonnet-4-20250514这里有个坑要提醒Base URL 一定不要写成https://taotoken.net/api/v1再加别的路径OpenClaw 内部会自己拼/v1/chat/completions你多写一层就 404。Model ID 要和你账号下可用的模型对齐写错了会报model not found。配好模型后先用一条命令验证 OpenClaw 能不能正常对话别急着接企业微信。在终端里跑openclaw chat --message 你好测试一下模型通道如果能看到正常回复说明模型层通了可以进入下一步。如果这里就报 401那问题在 Key 或 Base URL跟企业微信无关先把这层解决掉。这一步很多人跳过结果接完企业微信发现机器人不回消息排查半天才发现是模型没通白白浪费时间。另外提一句OpenClaw 的插件和渠道是两套东西。插件plugin负责扩展能力比如企微插件渠道channel负责消息进出比如企业微信渠道。接企微两样都要配顺序是先装插件再配渠道。3. 可复制配置Bot ID 获取与 OpenClaw 侧参数对照这一节是全文的核心我把企业微信后台和 OpenClaw 侧的参数一一对应列出来你照着填就行。先在企业微信客户端操作。打开企业微信进「工作台」找到「智能机器人」点「创建机器人」。创建时选择「API 模式」然后在接入方式里选「长连接」。这一步很关键选错了后面拿不到 Bot ID。创建完成后页面会显示 Bot ID 和 Secret 两个值Secret 通常只显示一次务必当场复制保存。如果关掉页面再想找可能得重新生成。拿到这两个值后回到 OpenClaw 侧。本地部署的话先装企微插件openclaw plugins install wecom/wecom-openclaw-plugin装完用openclaw plugins list确认插件在列表里。然后重启网关openclaw gateway restart接着添加渠道openclaw channels add交互式流程里「select channel」选「企业微信」然后依次输入 Bot ID 和 Secret选 finish。配对方式选「Pairing」。如果你是在腾讯云 Lighthouse 上部署的 OpenClaw可以走图形界面进轻量应用服务器实例的「应用管理」页在通道里选「企微机器人长链接」把 Bot ID 和 Secret 填进输入框点「添加并应用」弹框确认等一会儿就能看到配置生效然后重启。参数对照表如下建议截图保存企业微信后台项OpenClaw 侧对应项说明Bot IDchannels.wecom.bot_id机器人唯一标识长连接模式必填Secretchannels.wecom.secret机器人密钥仅创建时显示一次接入方式长连接channel type wecom-longconn不要选 URL 回调配对方式pairing首次配对需在企微里回一条命令对应的配置文件片段本地~/.openclaw/config.toml[[channels]] type wecom mode longconn bot_id 你的BotID secret 你的Secret pairing pairing注意mode字段必须是longconn写成callback会走 URL 回调逻辑长连接就建不起来。填完保存重启 OpenClawopenclaw gateway restart重启后看日志如果出现类似wecom long connection established的字样说明通道建起来了。如果日志里是connect failed或auth error先检查 Bot ID 和 Secret 有没有多余空格这是最常见的低级错误。4. 验证请求与消息收发确认长连接真的通了配置写完不代表通了得实际验证。验证分两层先验长连接通道再验消息收发。第一层看 OpenClaw 日志。重启后执行openclaw gateway logs --follow正常的话你会看到企微通道的握手日志。如果一直卡在connecting多半是网络出不去或者 Secret 错了。长连接是 OpenClaw 主动往外连所以你的机器只要能访问企业微信的服务器就行不需要公网入口。第二层在企业微信里发消息。找到你刚创建的机器人如果找不到去管理后台找它的二维码扫码进入会话。发一句「你好」这时候机器人会回一条配对密钥信息最后一行是一串命令。把这行命令复制回到终端粘贴执行完成配对。配对成功后重启一次 OpenClaw。再发一条消息比如「帮我查一下今天的待办」如果机器人正常回复说明整条链路通了。这里有个细节配对是一次性的配对完成后那串密钥就失效了别重复用。如果你想验证主动推送能力可以在 OpenClaw 里触发一次主动发消息。长连接模式支持机器人主动往会话里发内容这对做告警通知特别有用。测试方法是在 OpenClaw 的 Agent 逻辑里调用发送接口或者用 CLI 触发一次推送任务看企业微信里能不能收到。消息收发的验证要点我整理成几条被动回复用户发一句机器人回一句验证基本通道。多条回复让 Agent 输出较长内容看是否分多条陆续到达。主动推送无用户触发情况下机器人能否主动发消息。断线重连把网络断一下再恢复看长连接能否自动重连。这四条都过了才算真正接稳。很多人只验第一条就上线结果遇到网络抖动掉线后机器人就哑了所以断线重连一定要测。5. 本篇常见错误排查401、local proxy failed 与配对失败接企微过程中会碰到几类典型报错我按出现频率排一下。401 Unauthorized。这个最常见来源有两个一是 TaoToken 的 API Key 错了或过期二是企微的 Secret 填错。区分方法看报错上下文如果报错里带model或chat/completions那是模型层的 Key 问题如果带wecom或bot那是企微凭证问题。模型层 401 就去控制台重新生成 Key企微层 401 就回后台重新拿 Secret。local proxy failed。这个报错通常出现在 OpenClaw 启动阶段意思是本地代理或网关没起来。先确认openclaw gateway进程在跑用openclaw gateway status看状态。如果进程没起手动openclaw gateway start。还有一种情况是端口被占用改一下网关端口再试。reading choices 相关报错。这类错误一般出现在模型返回格式不符合预期时比如你用的 Model ID 实际不支持 OpenAI 兼容格式返回体里没有choices字段。解决办法是换一个确认兼容的 Model ID或者检查 Base URL 有没有写错路径。TaoToken 的 API 基址是https://taotoken.net/api别多加/v1。OAuth 或配对失败。配对阶段报错先确认 Bot ID 和 Secret 没填反。然后确认配对命令是完整复制的包括前缀。如果提示配对码过期重新在企业微信里发消息触发一次新的配对码。还有一种情况是机器人被多人同时配对导致状态冲突建议一个机器人只配一个 OpenClaw 实例。长连接建不起来但没报错。这种最隐蔽。检查mode字段是不是longconn检查插件版本是不是最新的用openclaw plugins list看企微插件版本。旧版插件可能不支持长连接模式升级一下openclaw plugins update wecom/wecom-openclaw-plugin排查时养成看日志的习惯openclaw gateway logs --follow基本能定位八成问题。日志里关键字搜wecom、auth、connect比盲猜快得多。6. 长期运行建议与接入文档入口接上只是开始长期跑还有几件事要注意。第一Secret 的保管。企微的 Secret 只在创建时显示一次丢了就得重新生成重新生成后所有已配的 OpenClaw 实例都要更新配置。建议把 Bot ID 和 Secret 存到密码管理器里别直接写在会提交到 Git 的配置文件里。生产环境用环境变量注入export WECOM_BOT_ID你的BotID export WECOM_SECRET你的Secret配置文件里引用变量而不是写死。第二长连接的稳定性。长连接会受网络质量影响建议在 OpenClaw 侧开启自动重连并配一个健康检查。如果跑在 Lighthouse 上可以设个定时任务每隔几分钟检查一次通道状态掉了就重启网关。第三模型成本控制。Agent 接上企微后调用量可能比你想的大尤其是群里多人同时问。建议在 TaoToken 控制台设好额度告警或者用 Coding Plan 这类包月方案控制成本。模型对话页面可以先用小流量验证效果确认没问题再放开。第四权限边界。企微机器人能读到的会话内容、能调用的 API 范围要在企业微信后台配好。别给机器人过大的权限尤其是涉及企业通讯录和文档的操作按最小必要原则来。如果你在配置过程中卡住了接入文档里有更细的参数说明和示例API Keys 页面可以管理你的模型密钥。需要验证模型效果的话模型对话页面能直接试。长期跑编码和 Agent 任务Coding Plan 的额度模型更划算。最后说个实操技巧把 OpenClaw 的配置文件和企微后台参数做成一张对照表贴在团队文档里下次换人维护或者加新机器人时照着表填就行能省掉大量重复排查。长连接这套方案本身不复杂坑基本都在参数填错和凭证过期上把这两块管好稳定性就有保障。