★ FEATURED ARTICLE 1. QClaw 是什么把 OpenClaw 装进微信和 QQ 的零门槛方案QClaw 是腾讯电脑管家团队基于 OpenClaw 开源框架做的一层工程化封装核心目标只有一个让没有 Node.js 基础、没配过环境变量、没申请过 API Key 的普通用户也能在微信和 QQ 里远程遥控自己电脑上的 AI Agent 干活。你可以把它理解成「被官方驯化过的原版小龙虾」——底层还是 OpenClaw 那套技能生态但安装、鉴权、通道接入全部被压缩成下载、双击、扫码三步。它和腾讯另一款 WorkBuddy 的路线完全不同。WorkBuddy 是 CodeBuddy 架构的自研产品面向企业微信、飞书、钉钉这类办公场景强调权限分级和安全审计QClaw 则是把 OpenClaw 原版打包走微信官方中转通道数据存在本地沙箱隔离定位是轻量级远程遥控。说白了WorkBuddy 是给职场人做复杂多步骤办公任务的QClaw 是给想低门槛体验 AI Agent 的普通用户玩的。微信接入这块有个关键设计需要先讲清楚QClaw 不会变成你的微信好友也不能读你的聊天记录更不能以你的身份给好友发消息。它的工作方式是——你在微信里跟电脑管家的官方客服号对话官方账号充当翻译中枢把你的指令转发给本地 QClaw 执行再把结果回传。这个「绕一层」的设计换来的是合规性避免了社区里那些非官方协议接入微信可能导致的封号风险。QQ 通道的逻辑类似同样是官方中转适合习惯用 QQ 做远程指令下发的用户。双通道并存的好处是微信适合日常随手发指令QQ 适合在群里做多设备协同或者文件传输场景。适合谁用三类人一是想体验 AI Agent 但被 OpenClaw 环境配置劝退的小白二是需要远程遥控家里或公司电脑执行轻量任务的用户三是想用统一 API 通道管理多个模型 Key 的开发者。如果你属于这三类下面的步骤可以完整跟做。2. 前置准备Node.js 环境与 TaoToken 统一 Key 配置虽然 QClaw 把大部分环境依赖都打包了但底层 OpenClaw 运行时仍然依赖 Node.js。官方安装包会自带一个精简运行时但如果你后续想自己装技能包、跑自定义脚本还是建议手动装一个 LTS 版本的 Node.js。我实测下来Node.js 20.x 和 22.x 都能正常跑18.x 在部分技能包上会有兼容警告。Node.js 安装很简单去官网下载 LTS 安装包一路下一步即可。装完后打开终端验证node -v npm -v正常输出类似v22.14.0和10.9.2就说明环境 OK。如果提示 command not foundWindows 用户检查是否勾选了「Add to PATH」macOS 用户检查是否用了 nvm 但没 source。接下来是 TaoToken 的前置配置。QClaw 本身赠送每日免费 Token但免费额度有限且只覆盖内置模型。如果你要接入 Claude、GPT 这类外部模型或者想在多个工具间统一管理 Key就需要一个统一的 API 通道。TaoToken 的作用就在这里它提供一个兼容 OpenAI 和 Anthropic 协议的 Base URL你只需要一个 Key就能在 QClaw、Cline、Claude Code 等多个工具间复用。先注册并拿到 Key。访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 后你需要确认三件套Base URL、API Key、Model ID。TaoToken 的 API 端点是https://taotoken.net/api注意这个地址不加 UTM 参数直接用于代码和配置。Model ID 根据你用的模型填比如claude-sonnet-4-20250514、gpt-4o等具体以控制台模型列表为准。这里有个容易踩的坑QClaw 内置的模型配置和 OpenClaw 原版的配置文件路径不一样。QClaw 把配置收在安装目录下的config文件夹里而 OpenClaw 原版在~/.openclaw/下。如果你之前装过原版 OpenClaw不要直接把原版配置复制过去字段名有差异。另外如果你打算用 Claude Code 或者 Cline 配合 QClaw 做编码任务TaoToken 的 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 有专门的套餐说明适合长期高频编码场景。模型对话调试可以用 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 先验证 Key 是否可用。3. 可复制配置QClaw 安装命令与微信/QQ 双通道参数QClaw 的安装分两步先装主程序再配通道。主程序去官网 https://qclaw.qq.com/ 下载对应系统的安装包Windows 是 exemacOS 是 dmg。安装过程跟装微信没区别双击、下一步、完成。首次启动会让你输入邀请码邀请码通过短信发送到登记手机申请链接是 https://wj.qq.com/s2/26010208/ltnx/ 。如果你不想用图形界面或者想在服务器上跑QClaw 也提供了命令行安装方式。前提是 Node.js 已就绪npm install -g qclaw/cli qclaw initqclaw init会引导你完成邀请码验证和基础配置。验证通过后配置文件会生成在~/.qclaw/config.jsonmacOS/Linux或%USERPROFILE%\.qclaw\config.jsonWindows。接下来是核心的 TaoToken 接入配置。打开config.json找到model和providers字段按下面这个结构改{ model: claude-sonnet-4-20250514, providers: { taotoken: { baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [ claude-sonnet-4-20250514, gpt-4o, claude-3-5-haiku-20241022 ] } }, channels: { wechat: { enabled: true, mode: official-relay }, qq: { enabled: true, mode: official-relay } } }注意mode字段必须填official-relay这是走腾讯官方中转通道的标识。填成direct或者ipad会触发合规检查轻则通道不生效重则邀请码被回收。如果你用 Cline 或者 Claude Code 配合 QClaw 做编码Cline 的 MCP 配置里也要写全三件套。Cline 的 settings 文件通常在 VS Code 的settings.json里MCP 配置片段如下{ mcpServers: { qclaw: { command: qclaw, args: [mcp, --stdio], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的TaoToken密钥, TAOTOKEN_MODEL: claude-sonnet-4-20250514 } } } }Claude Code 的配置在~/.claude/settings.json字段名略有不同{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }Codex 用户如果走auth.json路径在~/.codex/auth.json内容结构是{ openai: { baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: gpt-4o } }微信和 QQ 通道的扫码接入在 QClaw 主界面完成。点击「微信远程连接」弹出二维码用手机微信扫码。注意扫码的微信可以和电脑登录的微信不是同一个账号这点很灵活。扫码成功后手机微信里会出现一个 QClaw 客服号后续所有指令都在这个对话框里发。QQ 通道同理在设置里切换到 QQ 标签扫码绑定即可。配置改完后重启 QClaw让配置生效。重启命令qclaw restart或者直接在图形界面退出再打开。4. 验证请求连通性测试与成功结果确认配置写完不验证等于没配。QClaw 提供了内置的连通性测试命令qclaw doctor这个命令会依次检查 Node.js 版本、配置文件语法、TaoToken 端点可达性、模型列表拉取、微信/QQ 通道状态。正常输出类似[OK] Node.js v22.14.0 [OK] config.json syntax valid [OK] TaoToken endpoint reachable (https://taotoken.net/api) [OK] Model list fetched: 3 models available [OK] WeChat channel: official-relay active [OK] QQ channel: official-relay active如果某一项显示[FAIL]后面会跟具体原因对照第 5 节的排查表处理。更直接的验证方式是发一条真实请求。在终端里跑qclaw chat --message 帮我列出当前目录下的文件如果配置正确你会看到模型返回的文件列表。这一步验证的是 TaoToken 通道和模型调用链路。如果返回401 Unauthorized说明 Key 有问题如果返回model not found说明 Model ID 写错了。微信通道的验证在手机微信的 QClaw 客服号里发一句「帮我打开浏览器访问百度」。电脑端 QClaw 界面会显示收到的指令然后执行。实测下来第一次执行可能会慢几秒因为要启动浏览器进程。如果电脑端没反应检查 QClaw 是否在运行、微信通道是否显示已连接。QQ 通道验证类似在 QQ 里给绑定的机器人发指令观察电脑端是否响应。还有一个验证技巧用 TaoToken 的模型对话页面先单独测 Key。访问 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 在对话框里发一条消息如果能正常回复说明 Key 和额度都没问题问题就出在 QClaw 配置上。这样可以把故障范围缩小。成功的结果应该是终端qclaw doctor全绿qclaw chat能拿到模型回复微信和 QQ 发指令后电脑端有执行动作并回传结果。三者都通过说明整条链路打通。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来。以下四个是我和身边朋友在配 QClaw TaoToken 时实际遇到过的按出现频率排序。报错一401 Unauthorized完整报错通常是Error: 401 Unauthorized {error:{message:Invalid API key provided,type:invalid_request_error}}原因有三个Key 复制时带了空格、Key 已过期或被删除、Base URL 写成了带 UTM 的地址。排查步骤先确认config.json里apiKey字段没有首尾空格再去 TaoToken 控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 确认 Key 状态是 active最后确认baseURL是https://taotoken.net/api不要加任何查询参数。UTM 参数只用于网页跳转API 调用不能带。报错二local proxy failed完整报错Error: local proxy failed to start listen tcp 127.0.0.1:7890: bind: address already in use这个报错跟网络代理无关是端口冲突。QClaw 内置了一个本地转发服务默认监听 7890 端口。如果你电脑上已经有其他程序占用了这个端口比如某些开发工具就会冲突。解决办法改 QClaw 的本地端口。在config.json里加一行{ localProxy: { port: 7891 } }改成 7891 或其他空闲端口重启即可。查端口占用Windows 用netstat -ano | findstr 7890macOS/Linux 用lsof -i :7890。报错三reading choices完整报错TypeError: Cannot read properties of undefined (reading choices)这个报错说明模型返回的数据结构不符合 OpenAI 格式。常见原因是 Model ID 填了一个 TaoToken 不支持的模型或者 Base URL 指向了 Anthropic 原生端点但用了 OpenAI 格式解析。排查确认 Model ID 在 TaoToken 控制台的模型列表里确认baseURL是https://taotoken.net/api而不是/v1/messages这类具体端点。TaoToken 的/api会自动路由到对应协议不需要你手动指定。报错四OAuth 相关错误完整报错Error: OAuth token exchange failed {error:invalid_grant,error_description:authorization code expired}这个通常出现在 Claude Code 或 Codex 走 OAuth 登录的场景。如果你在 Claude Code 里用了ANTHROPIC_API_KEY环境变量就不应该再走 OAuth 流程。解决办法清掉 OAuth 缓存强制走 API Key。Claude Code 的 OAuth 缓存在~/.claude/oauth.json删掉这个文件然后在settings.json里确保ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL都配了。Codex 的 OAuth 缓存在~/.codex/auth.json如果里面同时有 OAuth token 和 API Key优先走 API Key把 OAuth 字段删掉。排查通用原则先跑qclaw doctor定位是哪一层出问题再用 TaoToken 的模型对话页面单独验证 Key最后检查配置文件语法。三步下来基本能覆盖 90% 的报错。6. 长期使用建议与统一通道管理QClaw 赠送的每日免费 Token 在 0 点自动更新适合轻度体验。但如果你要跑长任务、接外部模型、或者在多个工具间切换统一走 TaoToken 通道会更省心。一个 Key 管所有工具不用在每个工具里重复配 Key也不用担心某个工具的免费额度用完。长期编码或 Agent 场景建议看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 套餐按量计费比单次调用划算。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各工具的完整配置示例包括 Claude Code、Cline、Codex 的字段对照。Claude Code 用户如果走 Anthropic 协议deeplink 是 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 里面有专门的接入说明。最后提醒一点QClaw 的微信和 QQ 通道走的是官方中转不要尝试改成直连模式也不要用非官方协议接入。合规性是这个方案能长期用的前提。配置改完后记得跑一遍qclaw doctor全绿再日常使用。
阅读完成 · 觉得有帮助？
