1. 为什么要在手机 QQ 里远程操控本地 OpenClawOpenClaw 这类本地 AI Agent 最大的价值是它能直接读写你电脑上的文件、跑脚本、调工具而不是只会在对话框里聊天。但问题也随之而来它绑在电脑上你人一离开工位能力就断了。出门在外想让它整理个桌面、跑个数据汇总、把一份 PDF 转成表格还得先远程连回电脑体验很割裂。手机 QQ 远程操控本地 OpenClaw 解决的正是这个断点。链路其实不复杂手机 QQ 发一条消息 → QQ Bot 把消息投递到本机运行的 OpenClaw 网关 → OpenClaw 调用你配置好的模型执行任务 → 结果再通过 QQ 推回手机。整条链路里模型调用这一环最容易卡住因为你要同时维护多个厂商的 Key、额度和计费口径。我这次把模型侧统一收敛到 TaoToken用一个 Key 打通对话与编码模型再配合 QQ Bot 插件手机端就能稳定触达本地 AI。这篇面向想在移动端随时调用本地 AI 的开发者交付三样可直接复制的东西TaoToken 统一 Key 的配置方式、QQ Bot 接入参数、以及settings.json骨架。跟着做完你能在手机 QQ 里发一句指令让电脑上的 OpenClaw 真实执行并回传结果。2. 前置准备TaoToken 统一 Key 与 OpenClaw 环境2.1 为什么模型侧用 TaoToken本地 Agent 的模型调用有两个现实问题一是不同任务想用不同模型日常对话用轻量模型写代码用强模型二是多厂商 Key 分散管理额度、限流、账单各看各的。TaoToken 提供的是 OpenAI 兼容的统一接口你只需要一个 Key、一个 Base URL就能在 OpenClaw 里切换模型不用为每个厂商单独改配置。对 QQ 远程操控这个场景来说好处很直接手机发来的指令可能一会儿是「整理文件」这种轻任务一会儿是「生成爬虫代码」这种重任务统一 Key 让你在settings.json里按需指定模型而不用在手机端做任何切换。2.2 获取 Key 与确认接口地址先到控制台创建 API Key建议单独建一个给 OpenClaw 用的 Key方便后续按项目排查用量控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite创建后把 Key 复制到本地注意它通常只完整显示一次。接口地址统一用https://taotoken.net/api这个地址不加任何查询参数直接作为 OpenAI 兼容的 Base URL 使用。注意Key 不要写进会提交到 Git 的文件里。下面配置我会用环境变量引用避免明文泄露。2.3 OpenClaw 与 QQ 环境要求在动手接 QQ 之前先确认本机 OpenClaw 是活的。终端执行openclaw gateway status看到Running就说明网关正常。如果没装或版本偏旧先更新npm update -g openclawlatest openclaw --versionQQ 侧需要较新版本才能看到 Bot 入口手机 QQ 更新到近期版本即可。电脑端保持网关进程常驻别关终端窗口否则手机发来的消息没有接收方。3. 可复制配置settings.json 骨架与 QQ Bot 接入参数3.1 settings.json 骨架OpenClaw 的模型与插件配置集中在settings.json。下面这份骨架把模型侧指向 TaoTokenQQ Bot 侧留出参数位你按注释替换即可{ models: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, defaultModel: claude-sonnet-4-5, fallbackModel: gpt-4o-mini }, gateway: { port: 3000, host: 127.0.0.1 }, plugins: { qqbot: { enabled: true, appId: ${QQ_BOT_APPID}, appSecret: ${QQ_BOT_SECRET}, allowlist: [整理文件, 生成代码, 查资料], bindQQ: 你的QQ号 } } }几个关键点说明。baseUrl固定为https://taotoken.net/api不要在后面拼/v1之类的路径OpenClaw 的兼容层会自己处理。defaultModel填你常用的强模型fallbackModel填一个便宜的兜底模型主模型限流时自动降级。allowlist是安全阀只有列表里的指令前缀会被执行避免手机丢失后被人乱发指令。3.2 环境变量注入不要把 Key 明文写进 JSON。在启动网关前导出环境变量export TAOTOKEN_API_KEY你的TaoToken Key export QQ_BOT_APPID你的QQ Bot AppID export QQ_BOT_SECRET你的QQ Bot AppSecretWindows PowerShell 用$env:TAOTOKEN_API_KEY...。这样settings.json里只留占位符文件可以安全地放进版本管理。3.3 安装并启用 QQ Bot 插件openclaw plugin install qqbot --registry https://registry.npmmirror.com openclaw plugin enable qqbot安装完成后重启网关让配置生效openclaw gateway restart3.4 生成绑定二维码openclaw qq connect终端会输出一个二维码有效期通常几分钟。手机 QQ 扫码后确认绑定终端出现QQ Bot connected successfully即表示链路打通。如果二维码在 Windows 默认终端里显示乱码换 Windows Terminal 或 Cmder 重新执行。4. 验证请求从手机 QQ 发指令到本地执行回传4.1 第一步验证模型侧连通在接 QQ 之前先单独确认 TaoToken 这条模型链路是通的避免出问题时分不清是模型还是 QQ 的锅curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复链路正常}] }返回里能看到模型回复内容说明 Key 和 Base URL 都没问题。这一步过了再往下排查 QQ 才有意义。4.2 第二步手机 QQ 发测试指令在手机 QQ 的 OpenClaw 对话窗口发送你好测试连接正常会收到模型回复。如果这一步没反应先看网关是否在跑、插件是否启用别急着改配置。4.3 第三步验证本地真实执行发一条会触碰本地文件系统的指令确认不是只有模型在空转帮我统计桌面文件数量按类型分类结果推送给我预期结果是 QQ 收到类似「桌面共 12 个文件图片 5 个、文档 4 个、其他 3 个」的回复。能拿到这个结果说明「手机 QQ → 网关 → 模型 → 本地工具 → 回传」整条链路是通的。4.4 第四步验证远程场景把手机切到流量、电脑走另一条网络再发一条指令帮我查看 D 盘剩余空间推送给我跨网络仍能收到结果说明远程操控成立。如果这一步失败但同 Wi-Fi 下正常问题多半在端口可达性看下一节的排查。5. 本篇常见错排查5.1 扫码绑定失败或提示网络异常先确认手机和电脑在同一网络下做首次绑定绑定成功后再切远程。其次检查本机防火墙是否拦了网关端口临时放行 3000 端口重试。最后重启网关再生成新二维码旧码过期也会报网络异常。5.2 绑定成功但发消息无回复按顺序查三件事openclaw gateway status是否 Runningopenclaw plugin list里 qqbot 是否 enabledsettings.json里baseUrl是否误加了/v1。我试过把 Base URL 写成带/v1的地址结果模型请求 404QQ 侧表现就是一直不回。5.3 模型返回 401 或额度报错401 基本是 Key 问题环境变量没导出、Key 复制时带了空格、或者用了已删除的 Key。到 API Keys 页面重新生成一个替换后重启网关。额度类报错则检查defaultModel是否指向了当前不可用的模型临时切到fallbackModel验证。5.4 指令执行了但 QQ 收不到推送多数是指令里没写「推送给我」。OpenClaw 默认把结果留在本地会话需要显式要求回传。另外检查allowlist是否把这条指令前缀挡掉了被拦截的指令不会执行也不会推送。5.5 远程连接频繁掉线同 Wi-Fi 稳定、跨网络掉线通常是端口不可达。确认电脑不休眠、网关常驻必要时用长连接方案替代扫码方案。电脑休眠是隐形杀手设置里把睡眠关掉再测。6. 把模型侧和编码场景一起收进 TaoTokenQQ 远程操控跑通后你大概率会想让它干更重的活比如手机发一句「帮我写个爬虫脚本并跑通」让本地 OpenClaw 直接生成代码、执行、回传结果。这类编码任务对模型能力要求更高也更适合用 Coding Plan 来统一管理额度避免和日常对话抢同一个 Key 的配额。想先验证模型对话效果https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期编码 / Agent 任务https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档与参数细节https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite配置上你只需要在settings.json里把编码类任务指向 Coding Plan 对应的模型日常指令继续走轻量模型一个 Key 覆盖两种负载。这样手机 QQ 发来的指令无论轻重都能在本地稳定执行并回传不用在手机端做任何模型切换。
1. 为什么要在手机 QQ 里远程操控本地 OpenClawOpenClaw 这类本地 AI Agent 最大的价值是它能直接读写你电脑上的文件、跑脚本、调工具而不是只会在对话框里聊天。但问题也随之而来它绑在电脑上你人一离开工位能力就断了。出门在外想让它整理个桌面、跑个数据汇总、把一份 PDF 转成表格还得先远程连回电脑体验很割裂。手机 QQ 远程操控本地 OpenClaw 解决的正是这个断点。链路其实不复杂手机 QQ 发一条消息 → QQ Bot 把消息投递到本机运行的 OpenClaw 网关 → OpenClaw 调用你配置好的模型执行任务 → 结果再通过 QQ 推回手机。整条链路里模型调用这一环最容易卡住因为你要同时维护多个厂商的 Key、额度和计费口径。我这次把模型侧统一收敛到 TaoToken用一个 Key 打通对话与编码模型再配合 QQ Bot 插件手机端就能稳定触达本地 AI。这篇面向想在移动端随时调用本地 AI 的开发者交付三样可直接复制的东西TaoToken 统一 Key 的配置方式、QQ Bot 接入参数、以及settings.json骨架。跟着做完你能在手机 QQ 里发一句指令让电脑上的 OpenClaw 真实执行并回传结果。2. 前置准备TaoToken 统一 Key 与 OpenClaw 环境2.1 为什么模型侧用 TaoToken本地 Agent 的模型调用有两个现实问题一是不同任务想用不同模型日常对话用轻量模型写代码用强模型二是多厂商 Key 分散管理额度、限流、账单各看各的。TaoToken 提供的是 OpenAI 兼容的统一接口你只需要一个 Key、一个 Base URL就能在 OpenClaw 里切换模型不用为每个厂商单独改配置。对 QQ 远程操控这个场景来说好处很直接手机发来的指令可能一会儿是「整理文件」这种轻任务一会儿是「生成爬虫代码」这种重任务统一 Key 让你在settings.json里按需指定模型而不用在手机端做任何切换。2.2 获取 Key 与确认接口地址先到控制台创建 API Key建议单独建一个给 OpenClaw 用的 Key方便后续按项目排查用量控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite创建后把 Key 复制到本地注意它通常只完整显示一次。接口地址统一用https://taotoken.net/api这个地址不加任何查询参数直接作为 OpenAI 兼容的 Base URL 使用。注意Key 不要写进会提交到 Git 的文件里。下面配置我会用环境变量引用避免明文泄露。2.3 OpenClaw 与 QQ 环境要求在动手接 QQ 之前先确认本机 OpenClaw 是活的。终端执行openclaw gateway status看到Running就说明网关正常。如果没装或版本偏旧先更新npm update -g openclawlatest openclaw --versionQQ 侧需要较新版本才能看到 Bot 入口手机 QQ 更新到近期版本即可。电脑端保持网关进程常驻别关终端窗口否则手机发来的消息没有接收方。3. 可复制配置settings.json 骨架与 QQ Bot 接入参数3.1 settings.json 骨架OpenClaw 的模型与插件配置集中在settings.json。下面这份骨架把模型侧指向 TaoTokenQQ Bot 侧留出参数位你按注释替换即可{ models: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, defaultModel: claude-sonnet-4-5, fallbackModel: gpt-4o-mini }, gateway: { port: 3000, host: 127.0.0.1 }, plugins: { qqbot: { enabled: true, appId: ${QQ_BOT_APPID}, appSecret: ${QQ_BOT_SECRET}, allowlist: [整理文件, 生成代码, 查资料], bindQQ: 你的QQ号 } } }几个关键点说明。baseUrl固定为https://taotoken.net/api不要在后面拼/v1之类的路径OpenClaw 的兼容层会自己处理。defaultModel填你常用的强模型fallbackModel填一个便宜的兜底模型主模型限流时自动降级。allowlist是安全阀只有列表里的指令前缀会被执行避免手机丢失后被人乱发指令。3.2 环境变量注入不要把 Key 明文写进 JSON。在启动网关前导出环境变量export TAOTOKEN_API_KEY你的TaoToken Key export QQ_BOT_APPID你的QQ Bot AppID export QQ_BOT_SECRET你的QQ Bot AppSecretWindows PowerShell 用$env:TAOTOKEN_API_KEY...。这样settings.json里只留占位符文件可以安全地放进版本管理。3.3 安装并启用 QQ Bot 插件openclaw plugin install qqbot --registry https://registry.npmmirror.com openclaw plugin enable qqbot安装完成后重启网关让配置生效openclaw gateway restart3.4 生成绑定二维码openclaw qq connect终端会输出一个二维码有效期通常几分钟。手机 QQ 扫码后确认绑定终端出现QQ Bot connected successfully即表示链路打通。如果二维码在 Windows 默认终端里显示乱码换 Windows Terminal 或 Cmder 重新执行。4. 验证请求从手机 QQ 发指令到本地执行回传4.1 第一步验证模型侧连通在接 QQ 之前先单独确认 TaoToken 这条模型链路是通的避免出问题时分不清是模型还是 QQ 的锅curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复链路正常}] }返回里能看到模型回复内容说明 Key 和 Base URL 都没问题。这一步过了再往下排查 QQ 才有意义。4.2 第二步手机 QQ 发测试指令在手机 QQ 的 OpenClaw 对话窗口发送你好测试连接正常会收到模型回复。如果这一步没反应先看网关是否在跑、插件是否启用别急着改配置。4.3 第三步验证本地真实执行发一条会触碰本地文件系统的指令确认不是只有模型在空转帮我统计桌面文件数量按类型分类结果推送给我预期结果是 QQ 收到类似「桌面共 12 个文件图片 5 个、文档 4 个、其他 3 个」的回复。能拿到这个结果说明「手机 QQ → 网关 → 模型 → 本地工具 → 回传」整条链路是通的。4.4 第四步验证远程场景把手机切到流量、电脑走另一条网络再发一条指令帮我查看 D 盘剩余空间推送给我跨网络仍能收到结果说明远程操控成立。如果这一步失败但同 Wi-Fi 下正常问题多半在端口可达性看下一节的排查。5. 本篇常见错排查5.1 扫码绑定失败或提示网络异常先确认手机和电脑在同一网络下做首次绑定绑定成功后再切远程。其次检查本机防火墙是否拦了网关端口临时放行 3000 端口重试。最后重启网关再生成新二维码旧码过期也会报网络异常。5.2 绑定成功但发消息无回复按顺序查三件事openclaw gateway status是否 Runningopenclaw plugin list里 qqbot 是否 enabledsettings.json里baseUrl是否误加了/v1。我试过把 Base URL 写成带/v1的地址结果模型请求 404QQ 侧表现就是一直不回。5.3 模型返回 401 或额度报错401 基本是 Key 问题环境变量没导出、Key 复制时带了空格、或者用了已删除的 Key。到 API Keys 页面重新生成一个替换后重启网关。额度类报错则检查defaultModel是否指向了当前不可用的模型临时切到fallbackModel验证。5.4 指令执行了但 QQ 收不到推送多数是指令里没写「推送给我」。OpenClaw 默认把结果留在本地会话需要显式要求回传。另外检查allowlist是否把这条指令前缀挡掉了被拦截的指令不会执行也不会推送。5.5 远程连接频繁掉线同 Wi-Fi 稳定、跨网络掉线通常是端口不可达。确认电脑不休眠、网关常驻必要时用长连接方案替代扫码方案。电脑休眠是隐形杀手设置里把睡眠关掉再测。6. 把模型侧和编码场景一起收进 TaoTokenQQ 远程操控跑通后你大概率会想让它干更重的活比如手机发一句「帮我写个爬虫脚本并跑通」让本地 OpenClaw 直接生成代码、执行、回传结果。这类编码任务对模型能力要求更高也更适合用 Coding Plan 来统一管理额度避免和日常对话抢同一个 Key 的配额。想先验证模型对话效果https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期编码 / Agent 任务https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档与参数细节https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite配置上你只需要在settings.json里把编码类任务指向 Coding Plan 对应的模型日常指令继续走轻量模型一个 Key 覆盖两种负载。这样手机 QQ 发来的指令无论轻重都能在本地稳定执行并回传不用在手机端做任何模型切换。
