1. 微信发一句话本地 OpenClaw 就动起来了QClaw 是腾讯推出的桌面端 AI Agent 助手它做的事情可以一句话概括把本地 OpenClaw 那套命令行操作包装成一个能扫码绑定微信、在聊天窗口里发指令就能远程干活的工具。适合谁已经装过 OpenClaw、被 Node 版本和端口冲突折腾过的人或者想给家里那台常开的电脑配个「远程打工人」但不想每次出门都远程桌面连回去敲命令的人。它和 OpenClaw 的关系不是替代而是「外壳 遥控器」。OpenClaw 负责本地执行、跑 Skills、调模型QClaw 用 Electron 做了一层桌面守护进程把 Gateway 的启停、配置读写、消息通道都接管了再通过微信小程序把指令送进来。整条链路里模型调用这一环是绕不开的——本地 Agent 要干活就得有可用的 API Key。这篇就围绕这条链路拆Electron 端怎么和 AI Agent 通信、OpenClaw 的配置文件骨架长什么样、QClaw 的 settings.json 怎么接入统一 Key最后用一条微信指令验证闭环。我试过把模型接入层单独抽出来用 TaoToken 的统一 Key 管理好处是 QClaw 和 OpenClaw 两边不用各配一套密钥换模型只改一个地方。下面按可复制的顺序来。2. 先理清 QClaw 与 OpenClaw 的通信链路很多人卡在「我装了 QClaw为什么微信发指令没反应」。根因通常是没搞清数据从微信到本地 Agent 走了几段路。拆开看是四段第一段微信小程序 → QClaw 云端信令。你在微信里发的文字先到 QClaw 的消息通道这一段是加密转发的不落业务数据。第二段QClaw 云端 → 本地 Electron 守护进程。Electron 端常驻在你电脑上维持一条长连接收到指令后唤醒本地服务。第三段Electron → OpenClaw Gateway。QClaw 通过本地回环地址调用 OpenClaw 的 Gateway 接口把自然语言指令交给 Agent 解析。第四段OpenClaw Agent → 模型 API。Agent 把任务拆成步骤调用配置好的模型接口拿到结果后原路返回最终在微信里显示。关键点在于第三段和第四段之间Gateway 必须处于运行状态且模型配置有效。QClaw 的「一键关联 OpenClaw」本质就是帮你写好 Gateway 的连接参数但模型 Key 这块如果你之前 OpenClaw 里配的是临时额度很容易过期导致微信指令发出去、Agent 转一圈、最后报鉴权失败。注意QClaw 的数据处理在本地完成任务执行和文件读写不上传云端。但模型调用本身需要出网请求 API这部分流量走的是你配置的接口地址和「数据是否上云」是两回事别混为一谈。理解了这四段排障就有方向了微信没反应看第一二段Agent 不执行看第三段执行了但报错看第四段。3. OpenClaw 配置文件骨架与 QClaw 接入统一 Key先给 OpenClaw 的配置骨架。OpenClaw 的配置一般放在用户目录下的配置文件夹里核心是一个 JSON 文件描述 Gateway 监听、模型提供方、Skills 路径。下面是一个可复制的最小骨架字段名按你本地版本为准重点是结构{ gateway: { host: 127.0.0.1, port: 18789, authToken: local-gateway-token-please-change }, models: { default: taotoken-claude, providers: { taotoken-claude: { type: anthropic-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的统一Key, model: claude-sonnet-4-20250514 } } }, skills: { dir: ./skills, autoLoad: true }, agent: { maxSteps: 12, timeoutMs: 120000 } }这里baseUrl填https://taotoken.net/api注意 API 地址不带任何查询参数。apiKey用你在控制台生成的统一 Key这样 OpenClaw 侧就接好了。接着是 QClaw 侧的 settings.json 片段。QClaw 关联已有 OpenClaw 后会在自己的配置里记录 Gateway 地址和模型覆盖项。如果你想让 QClaw 触发的任务也走同一个 Key在它的 settings.json 里补上模型段{ openclaw: { mode: attach, gatewayUrl: http://127.0.0.1:18789, gatewayToken: local-gateway-token-please-change }, modelOverride: { enabled: true, baseUrl: https://taotoken.net/api, apiKey: sk-你的统一Key, model: claude-sonnet-4-20250514 }, wechat: { bindStatus: bound, commandPrefix: /agent } }两个文件的gatewayToken必须一致否则 Electron 端调 Gateway 会被拒。modelOverride打开后QClaw 下发的任务会优先用这里的模型配置避免和 OpenClaw 全局配置打架。Key 从哪来进控制台创建路径是 console生成后复制。想先验证模型通不通可以用模型对话页面直接发一条测试消息确认 Key 有效再写进配置省得在配置文件里反复试错。4. 验证一条微信指令跑通远程闭环配置写完先别急着掏手机。本地验证分三步每步都有明确的成功标志。第一步启动 OpenClaw Gateway确认端口在听# 启动 Gateway按你本地实际启动方式 openclaw gateway start # 另开终端验证端口 curl -s http://127.0.0.1:18789/health返回类似{status:ok}就说明 Gateway 活着。如果返回连接拒绝说明服务没起来先解决这个别往下走。第二步直接打模型接口确认 Key 和地址都对curl -s https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-你的统一Key \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role:user,content:回复两个字收到}] }能拿到正常回复内容说明第四段链路没问题。这一步失败微信那边再怎么发都是白搭。第三步微信端触发。打开 QClaw 客户端确认显示「已关联 OpenClaw」然后在微信里发一条带前缀的指令比如/agent 帮我列出桌面所有 png 文件移动到 图片归档 文件夹成功标志有三个微信里先回「任务已接收」几秒后回执行结果QClaw 客户端日志出现对应的 Agent 调用记录本地目标文件夹里文件真的被移动了。三个都满足闭环就跑通了。如果只想先验证「微信能不能唤醒本地」可以发一条最轻的指令比如/agent 现在几点这种不需要文件权限排障时干扰最小。5. 本篇常见错排查微信发指令一直转圈没回复。先看 QClaw 客户端是否在线Electron 进程被系统休眠杀掉是常见原因把电源策略里「睡眠」关掉或把 QClaw 加入后台常驻白名单。提示 Gateway 连接失败。九成是gatewayToken两边不一致或者 OpenClaw 重启后端口变了。用curl打一下 health 接口确认端口再核对两个配置文件里的 token。Agent 执行到一半报鉴权错误。模型 Key 失效或额度用尽。去控制台看 Key 状态重新生成后同步更新 OpenClaw 和 QClaw 两处配置。用统一 Key 的好处在这里体现只改一个来源两边引用同一个值。指令发出去了但 Agent 理解偏了。这不是链路问题是指令太模糊。把任务拆成「对象 动作 目标」三段比如「桌面 png 文件 / 移动 / 图片归档文件夹」比「整理一下桌面」成功率高得多。关联 OpenClaw 后原有 Skills 不见了。QClaw 关联模式默认读 OpenClaw 的 skills 目录检查skills.dir路径是不是相对路径导致解析错位改成绝对路径最稳。排障时如果反复卡在接入环节直接翻接入文档对照字段比在配置文件里猜快得多。6. 把 Key 和入口固定下来跑通一次之后建议把两件事固定成习惯。一是模型接入统一走一个 Key 来源OpenClaw 和 QClaw 都引用它换模型、续额度只动一处避免「微信能唤醒但 Agent 报错」这种跨文件不一致的坑。二是把常用指令沉淀成模板放在微信收藏或 QClaw 的快捷指令里远程触发时直接调用减少自然语言歧义。如果你还在选模型阶段可以先用模型对话把几个候选模型各跑几条真实任务对比延迟和结果质量再决定写进配置的是哪个。长期跑编码类、Agent 类任务的话Coding Plan 这种按周期计费的方式比单次调用更可控适合把 QClaw 当常驻工具用的人。配置入口和 Key 管理都在控制台接入细节看文档模型验证走对话页。链路本身不复杂难的是每段都确认过再往下走——先 Gateway 活着再 Key 有效最后才是微信触发。按这个顺序基本一次就能跑通。