1. 微信/企业微信接入腾讯QClaw 到底在解决什么问题腾讯QClaw社区里也常被叫成“小龙虾”本质是一个跑在本地电脑上的 AI 执行体它能读文件、跑命令、操作浏览器而微信/企业微信接入腾讯QClaw 要解决的核心问题只有一个让你不用坐在电脑前用手机上的 IM 就能给电脑上的 AI 下发任务。你在企业微信里发一句“帮我把昨天那份周报整理成表格”QClaw 在本机执行完把结果回给你。它不是一个云端 SaaS而是“IM 当遥控器、本地当执行机”的组合。适合谁三类人最需要一是经常在外面跑、但电脑上挂着长任务的开发者二是想把 AI 能力接进企业微信工作流、给团队做内部助手的同学三是已经在用 OpenClaw 系列、想补齐 IM 通道的玩家。微信侧和企业微信侧的接入路径不完全一样微信更偏个人号插件式接入企业微信则走官方「智能机器人 API 模式」的正规通道稳定性和可管理性都更好所以这篇重点讲企业微信这条链路同时把微信侧的差异点标出来。先给结论整条链路的关键就三个东西——Bot ID、Secret、连接方式长连接。企业微信负责生成凭据QClaw 负责用凭据建立 WebSocket 长连接连上之后消息双向流通。听起来简单但实际踩坑基本都集中在“凭据填错”“连接方式不一致”“QClaw 没在跑”这三类。下面按可复制的顺序拆开讲每一步都给到你能直接照做的动作。需要说明的是QClaw 本身是本地程序它调用大模型能力时需要一个稳定的 API 入口。如果你希望把模型调用统一走一个兼容 OpenAI 协议的中转层方便在 QClaw、Cline、Claude Code 等多个工具间复用同一套 Key可以了解下 TaoToken官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址 https://taotoken.net/api 。它的作用是给你一个统一的 Base URL 和 KeyQClaw 里配置模型时把这两项填进去即可不改变企业微信这条接入链路本身。2. 接入前的前置条件与 TaoToken 统一模型入口配置在动企业微信之前先把“地基”打好否则后面联调时你分不清是 IM 通道的问题还是模型通道的问题。前置条件清单如下逐条核对第一电脑上已安装并能正常启动 QClaw打开后左下角能看到设置入口。第二企业微信客户端升级到较新版本否则工作台里搜不到「智能机器人」。第三你的企业微信账号有创建机器人的权限——管理员走管理后台普通成员走客户端工作台两条入口后面都会给。第四电脑网络能正常出网因为长连接要连企业微信服务器模型调用还要连模型 API。这里重点说模型入口。QClaw 干活时要调模型如果你每个工具都单独配一套 Key管理起来很乱。我试过用统一入口的方式把模型调用收敛到一个兼容 OpenAI 协议的地址上QClaw、Cline、Codex 这些工具共用同一个 Base URL 和 Key换模型只改 Model ID 一处。以 TaoToken 为例你需要准备三件套配置项填写内容说明Base URLhttps://taotoken.net/api兼容 OpenAI 协议末尾不要多加/v1之外的路径API Key在控制台创建的 Key形如sk-开头妥善保存Model ID例如claude-sonnet-4-5等以控制台模型列表为准别凭记忆写获取 Key 的路径是进入控制台 → API Keys → 创建新 Key。控制台地址 https://taotoken.net/console 创建 Key 页面 https://taotoken.net/api-keys 。创建后立刻复制保存页面刷新后不再完整显示。如果你用的是 Claude Code 这类工具配置方式是在 settings 里指定环境变量如果是 Cline 这类 VS Code 插件则在插件设置里填 Base URL、Key、Model ID 三项。QClaw 的模型配置同理找到模型/API 设置区把上面三件套填进去。注意企业微信接入用的是 Bot ID 和 Secret模型调用用的是 API Key这两套凭据不要混。很多人第一次配会把 Secret 填到模型 Key 的位置结果机器人能连上但不回话。配置模型入口时建议先单独验证一次别等企业微信全配好了才发现模型不通。验证方式很简单用 curl 打一次对话接口curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字通了}] }返回里choices[0].message.content是“通了”说明模型通道没问题。这一步过了再去做企业微信侧排障范围直接砍一半。模型对话也可以直接在网页端试https://taotoken.net/models 不用写代码就能确认 Key 和模型是否可用。3. 企业微信创建智能机器人并获取 Bot ID 与 Secret 的可复制配置这一步是整个接入的核心凭据就是在这里生成的。先选入口按你的账号角色二选一管理员路径企业微信管理后台 →「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」→ 选择「API 模式创建」。普通成员路径企业微信客户端 →「工作台」→ 搜索「智能机器人」→「创建机器人」→「手动创建」→「API 模式创建」。如果工作台里搜不到「智能机器人」八成是版本太旧先升级客户端。没有企业微信账号的去官网免费注册一个企业即可个人也能建。进入创建页面后按顺序做这几件事。第一填写机器人名称建议写「QClaw 助手」这种一眼能认出来的。第二点「可使用的成员」后面的「修改」勾选需要用这个机器人的成员、部门或标签——这一步决定谁能跟它对话别漏。第三在 API 配置页连接方式务必选「使用长连接」这是和 QClaw 对接的前提选错了后面连不上。第四保存后页面会生成 Bot ID点「获取 Secret」拿到密钥两个都复制保存好。第五API 模式不支持预览调试直接保存配置就行别在页面上找测试按钮。把这两项凭据整理成一份配置清单方便后面填进 QClaw{ channel: wecom, connect_mode: websocket_long_connection, bot_id: 你的BotID, secret: 你的Secret, note: Secret仅显示一次泄露需在后台重置 }这份 JSON 不是给程序直接读的是给你自己对照用的避免复制时串行。实际填的时候QClaw 里对应的是「远控通道 → 企业微信 → 配置」弹窗里面选「WebSocket 长连接」然后把 Bot ID 和 Secret 分别粘进去。这里有个细节Secret 复制时极易带上首尾空格粘进去之前建议先粘到纯文本编辑器里看一眼。长连接注册失败十有八九是这个原因。另外如果 Secret 已经泄露或失效回企业微信后台重新获取一次旧的自然作废。微信侧和企业微信侧的差异要提一句微信个人号那条链路更偏插件式接入社区里常说的 ClawBot 插件配置项和入口跟企业微信不一样稳定性也受个人号策略影响企业微信这条是官方 API 模式凭据规范、可管理成员、能拉群更适合长期用。所以如果你两边都想接建议先把企业微信这条跑通再回头折腾微信侧。4. 在 QClaw 中绑定并完成消息收发联调验证凭据拿到后回到 QClaw 完成绑定。打开 QClaw点左下角设置按钮进入「远控通道」选择「企业微信」点「配置」。弹窗里连接方式选「WebSocket 长连接」把 Bot ID 和 Secret 填进去点「连接」。连接需要等一会儿别急着判定失败长连接建立有个握手过程。连接成功后去企业微信通讯录的「智能机器人」分组下找到你刚建的机器人点「发消息」发一句“你好”做连通测试。如果配置正确QClaw 会收到消息并在企业微信里回复。这一步能回说明 IM 通道和模型通道都通了。联调时建议按这个顺序验证出问题好定位第一步只验证通道。发“你好”看是否有任何回复。有回复说明链路通完全没反应先查 QClaw 是否在运行、连接方式是否两边都是长连接。第二步验证模型。发一个需要模型思考的问题比如“把 1 到 10 的偶数列出来”。如果通道通但这类问题不回说明模型配置有问题回去检查 Base URL、Key、Model ID 三件套。第三步验证执行能力。发一个需要操作本机的任务比如“在当前目录创建一个 test.txt 并写入 hello”。这一步能成说明 QClaw 的执行权限正常。第四步拉群测试。建群时把「QClaw 助手」拉进去在群里 它 提问。群场景下注意 的格式不同客户端略有差异 不到机器人它收不到消息。联调时可以用一段脚本模拟消息发送来辅助排查虽然企业微信侧消息由客户端发出但你可以用日志确认 QClaw 是否收到# 查看 QClaw 运行日志路径以实际安装为准 tail -f ~/.qclaw/logs/channel.log | grep -i wecom\|websocket日志里能看到长连接建立、消息接收、模型调用、回复发送几个阶段。哪一步断了问题就在哪。实测下来最常见的断点是长连接握手失败和模型 401前者查凭据空格后者查 Key 是否有效。5. 常见报错排查401、长连接注册失败与无响应把真实会遇到的报错对照着排比盲目试快得多。报错一模型调用返回 401 Unauthorized。这是模型通道的鉴权失败跟企业微信无关。原因通常是 API Key 填错、Key 已删除、或者 Base URL 写错导致请求打到了错误的地址。排查动作确认 Base URL 是https://taotoken.net/apiKey 是sk-开头且未过期Model ID 在控制台模型列表里存在。改完重启 QClaw 再试。报错二长连接注册失败 / local proxy failed。这个报错指向企业微信侧的长连接没建起来。三个检查点企业微信侧创建机器人时是否选了「使用长连接」Bot ID 和 Secret 是否复制完整、有没有多余空格Secret 是否已失效。重新复制一遍凭据注意别把 Bot ID 和 Secret 填反。如果企业微信侧改过连接方式QClaw 侧也要同步改成一致。报错三机器人完全无响应。分两种。一种是 QClaw 没在运行或者运行了但远控通道没开——先确认电脑上 QClaw 进程活着设置里企业微信通道显示已连接。另一种是消息发出去了但 QClaw 没收到检查机器人「可使用的成员」是否包含你当前账号没勾选的话你发消息它收不到。报错四返回内容里出现 reading choices 相关错误。这类通常是模型返回结构解析异常多半是 Model ID 写错导致返回了非预期格式或者 Base URL 末尾路径不对。核对 Model ID 拼写确认请求路径是/v1/chat/completions。报错五OAuth / 授权类报错。如果你在配置过程中看到 OAuth 字样通常是某个工具在走它自己的授权流程而不是企业微信这条链路。企业微信 API 模式用的是 Bot ID Secret不走 OAuth。遇到这类报错先确认你操作的是不是正确的配置入口。把上面这些整理成一张速查表现象最可能原因处理动作401Key 错/过期/Base URL 错核对三件套重启 QClaw长连接注册失败连接方式不一致/凭据带空格两边都选长连接重贴凭据无响应QClaw 没跑/成员未授权启动 QClaw勾选可用成员reading choicesModel ID 或路径错核对模型名与请求路径OAuth 报错走错配置入口确认用 Bot IDSecret 而非 OAuth排障时如果确认是模型通道问题接入文档里有各工具的配置示例可对照https://taotoken.net/doc 。模型本身是否可用可以直接在模型对话页发一条消息验证https://taotoken.net/models 。6. 长期跑 IM AI 工作流的通道选择与 CTA把最小链路跑通只是开始真正要长期用得考虑两件事通道稳定性和模型成本可控性。企业微信这条官方 API 模式通道凭据规范、成员可管理、支持拉群适合团队内部长期用微信个人号那条更灵活但受策略影响大适合个人尝鲜。如果你要做的是“手机遥控电脑干活”这种高频场景建议以企业微信为主通道。模型侧如果你同时用 QClaw、Cline、Claude Code 多个工具统一走一个兼容 OpenAI 协议的入口能省很多事——换模型只改 Model IDKey 只维护一份。需要长期编码或跑 Agent 任务的可以看下 Coding Planhttps://taotoken.net/coding-plan 它面向的就是这种持续调用场景。只想先验证模型通不通的直接用模型对话页最快https://taotoken.net/models 。要创建和管理 Key 的去控制台https://taotoken.net/console Key 管理页https://taotoken.net/api-keys 。最后给一个实操建议把企业微信机器人的 Bot ID 和 Secret 存进你的密码管理器别只放在聊天记录里模型 Key 也一样。这套链路一旦跑通你等于给自己配了一个“随身 AI 执行入口”后面加新工具时只要复用同一套模型入口接入成本会低很多。