1. QClaw 内测邀请码到手后微信里直接跑 OpenClaw 的配置记录QClaw 是腾讯把 OpenClaw 这套本地 Agent 能力做了一层封装后的桌面客户端核心卖点就一句话装完之后你在微信里发消息电脑上的 OpenClaw 就替你干活。它适合两类人一类是之前被 OpenClaw 原版环境配置劝退的新手另一类是手里有 Windows 或 macOS 机器、想让 AI 直接操作本地文件和应用、又不想天天守着电脑的人。我这次拿到的是 Windows 内测邀请码Mac 端不需要邀请码可以直接下载所以下面会同时覆盖 Windows 和 macOS 两条路径。需要先讲清楚一个前提QClaw 不是把 OpenClaw 搬到微信里运行微信只是它的指令通道。真正执行任务的还是你电脑上的 OpenClaw 进程微信负责把自然语言指令传过去、再把执行结果回传。理解这一点后面配置通道参数、排查消息收发失败时就不会绕晕。整个流程分四段激活邀请码拿到安装包、部署 OpenClaw 运行环境、绑定微信通道、发消息验证收发。每一段我都会给出可复制的配置和明确的成功判据你照着做就行。2. TaoToken 前置准备给 OpenClaw 配一个稳定的模型入口OpenClaw 本身是 Agent 框架它自己不产出模型能力得接一个模型服务才能跑。QClaw 内置了 Kimi、GLM 这类常用模型日常简单指令够用但一旦你要跑复杂任务比如让它读一整个项目目录再生成代码、或者做多轮工具调用内置模型的上下文和稳定性就容易顶不住。这时候更稳的做法是给 OpenClaw 单独配一个模型入口我这边用的是 TaoToken。TaoToken 是一个模型 API 聚合入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是让你用一个统一的 Base URL 和 Key去调用不同厂商的模型OpenClaw 这类工具只要支持自定义 OpenAI 兼容接口就能直接接进来。对 QClaw 场景来说好处是模型切换不用改客户端改配置里的 Model ID 就行。前置准备分三步。第一步注册后在控制台创建一个 API Key入口在 https://taotoken.net/console/api-keys Key 只在创建时完整显示一次复制下来存好。第二步确认你要用的模型 ID常见的有 claude 系列、gpt 系列具体以文档为准文档在 https://taotoken.net/doc 。第三步想先验证 Key 能不能通可以直接去模型对话页面 https://taotoken.net/chat 发一条消息能正常返回就说明 Key 和额度都没问题。这里要提醒一句OpenClaw 的模型配置和 QClaw 内置模型是两套东西。QClaw 内置模型走的是它自己的通道你不需要管只有当你想让 OpenClaw 用外部模型时才需要填 TaoToken 的 Base URL 和 Key。两者可以共存切换时在 OpenClaw 的配置里改就行。如果你打算长期跑编码类 Agent 任务可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan 比按量调用更适合高频场景。3. 可复制配置Windows 与 macOS 双端的通道参数填写这一节是全文最核心的部分配置写错一个字微信消息就发不出去。先讲 Windows再讲 macOS最后给 OpenClaw 接 TaoToken 的配置文件片段。Windows 端。拿到邀请码后去官网 https://claw.guanjia.qq.com/ 输入邀请码解锁下载文件名形如 QClaw-Windows-Setup.exe。双击安装路径保持默认别改到带中文或空格的目录否则后面 OpenClaw 起进程时容易报路径错误。安装完勾选立即运行。首次启动会弹「一键部署 OpenClaw」点确认它会自动拉取运行环境和内置模型等进度条走完。部署完成后主界面出现「关联微信」按钮点它生成二维码二维码有效期 5 分钟超时要重新点。手机微信扫码弹授权提示点允许微信里会多出一个「龙虾」客服号。注意它不是好友形态在服务通知或订阅号列表里不能拉群。绑定成功后 QClaw 界面显示「微信已连接」。macOS 端。Mac 不需要邀请码直接在官网下载 dmg拖进 Applications。首次打开如果提示「无法验证开发者」去系统设置-隐私与安全性里点「仍要打开」。Apple Silicon 和 Intel 芯片的包不通用下载时看清架构。后续部署和绑定流程和 Windows 一致扫码授权后同样在微信里出现「龙虾」客服号。关键一步是激活会话。绑定完必须立刻在微信「龙虾」窗口发一条任意文字比如「你好」。不发这条QClaw 后台不会建立长连接后面所有指令都会石沉大海。这一步 90% 的新手会漏。接下来是 OpenClaw 接 TaoToken 的配置。OpenClaw 的模型配置一般放在用户目录下的配置文件中Windows 在%USERPROFILE%\.openclaw\config.jsonmacOS 在~/.openclaw/config.json。用编辑器打开填入下面这段{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: claude-sonnet-4-5, max_tokens: 8192, temperature: 0.7 }, agent: { workspace: ./workspace, auto_approve: false } }三个字段必须对齐Base URL 填https://taotoken.net/api不要多加斜杠api_key 填你在控制台创建的那串model_id 填文档里确认过的模型 ID。改完保存重启 OpenClaw 进程让配置生效。如果你用的是 Codex 类工具认证信息在~/.codex/auth.json结构不同但同样是 Base URL、Key、Model ID 三件套别混用。4. 验证请求从微信发指令到看到执行结果配置写完不算完得跑通一次完整链路才算成功。验证分三层一层层来哪层断了就停在哪层排查。第一层验证 OpenClaw 能连上模型。在电脑上打开终端进到 OpenClaw 目录跑一条最简请求。如果你装了 curl可以直接打 TaoToken 的接口curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复ok}] }返回里带choices字段且内容正常说明 Key、Base URL、模型 ID 三者都对。如果返回 401是 Key 问题返回 model not found是 Model ID 写错。第二层验证微信通道。在微信「龙虾」窗口发一条简单指令比如「在桌面新建一个 test 文件夹」。观察两个地方微信里有没有回执电脑桌面上有没有真的出现文件夹。两个都满足说明通道和执行都通了。如果微信有回执但桌面没动静是 OpenClaw 权限没给够去系统设置里把文件访问和终端控制权限打开。第三层验证复杂任务。发一条带多步的指令比如「整理桌面文件统计数量生成一份报告」。这条会触发 OpenClaw 的工具调用链能完整跑完并回传报告说明模型上下文和 Agent 循环都正常。我实测下来这一步最能暴露模型能力问题内置模型经常跑到一半断掉换成 TaoToken 上的大模型后稳定很多。成功判据很明确微信收到结构化回执电脑上文件真实变化任务多步执行不中断。三条都过你的 QClaw 就算真正跑通了。5. 本篇常见错排查401、local proxy failed 与消息无响应配置过程中最容易撞的几个报错我按出现频率排一下每个都给定位方法。401 Unauthorized。这个基本只出在模型调用层。原因有三种Key 复制时带了空格、Key 已删除或额度耗尽、Base URL 写成了带路径的地址。排查顺序是先重新复制 Key再去控制台确认额度最后检查 Base URL 是不是干净的https://taotoken.net/api。注意别把官网地址填进 Base URL官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 带一堆参数填进去必错。local proxy failed。这个报错通常出现在 OpenClaw 启动阶段意思是本地代理端口起不来。常见原因是端口被占用或者杀毒软件拦了进程。解决办法是先关掉杀毒软件和防火墙再重启 QClaw如果还不行去 OpenClaw 配置里把本地端口从默认值改成 18080 这类不常用的端口。reading choices 报错。这个说明请求发出去了但返回体里没有choices字段通常是模型 ID 不被支持或者返回的是错误 JSON。去 https://taotoken.net/doc 核对当前可用的模型 ID别用已经下线的名字。OAuth 相关报错。如果你在配置里误开了 OAuth 认证模式而 TaoToken 走的是 API Key 模式就会报这个。把配置里的认证方式改回api_key即可。Codex 的 auth.json 里如果混了 OAuth 字段也要清掉。微信消息发出去没反应。先确认你有没有发那条激活消息没发的话后台长连接根本没建立。再确认 QClaw 界面是不是显示「微信已连接」显示未连接就重新扫码。最后看电脑上 OpenClaw 进程还在不在进程挂了微信这边不会有任何提示只会静默失败。6. 语义一致 CTA把模型入口和通道都固定下来跑通一次之后建议把配置固化别每次重装都从头来。OpenClaw 的 config.json 备份一份TaoToken 的 Key 存在密码管理器里QClaw 的安装包留着换机器时直接复用。模型这块日常轻量指令用内置的就够复杂任务切到 TaoToken 上的大模型切换只改 model_id 一个字段。如果你还没建 Key去 https://taotoken.net/console/api-keys 创建想先试模型效果去 https://taotoken.net/chat 发两条消息感受一下配置细节对不上查 https://taotoken.net/doc 长期跑编码和 Agent 任务看 https://taotoken.net/coding-plan 。通道侧微信绑定和二维码在 QClaw 主界面OpenClaw 的模型配置在本地 config.json两边各管各的别搞混。最后说个实际经验QClaw 的微信通道偶尔会抽风消息延迟几秒到十几秒都算正常别一没秒回就以为挂了。真正要盯的是电脑上 OpenClaw 进程的日志那里才是真相。把日志开着跑出问题第一时间能定位比在微信里反复发指令有效得多。