1. 为什么要把 OpenClaw 接到 QQ 上OpenClaw 是一个开源的 AI 智能体项目它能理解自然语言指令并在你的电脑上主动执行任务比如整理文件、抓取资讯、生成报告。它本身没有独立 App而是通过聊天软件作为入口来交互。QQ 作为国内使用频率极高的通讯工具把它作为 OpenClaw 的接入渠道意味着你可以在手机 QQ 或电脑 QQ 里直接给智能体派活不用额外打开任何新应用。这篇教程面向的是想快速跑通 OpenClaw 对接 QQ 机器人的开发者或技术爱好者。整个链路包括准备 Node 环境、安装 OpenClaw、安装 QQ 插件、在 QQ 开放平台创建机器人、配置参数、重启服务、扫码验证。同时我会把模型调用统一收敛到 TaoToken 的 Key/API 通道上这样你只需要管理一个 Key就能切换不同模型不用在多个平台之间来回折腾。适合谁看有基本命令行操作经验、想在本地部署一个能干活儿的 AI 助手、并且希望用统一 API 通道管理模型调用的朋友。如果你之前没接触过 OpenClaw也没关系每一步我都会给出可复制的命令和配置片段。我试过用不同的模型通道来驱动 OpenClaw实测下来把模型调用统一到一个 API 通道上后续换模型、调参数会省心很多。下面从环境准备开始一步步走完整个闭环。2. TaoToken 前置准备与 Node 环境搭建在开始对接 QQ 之前先把模型调用的通道确定下来。OpenClaw 需要一个大模型来理解指令和生成回复这里我选择通过 TaoToken 的统一 API 通道来调用模型。TaoToken 的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。为什么用 TaoToken 而不是直接对接某个模型厂商原因很简单OpenClaw 在运行过程中可能需要切换不同模型来完成不同任务如果每个模型都去单独申请 Key、单独配置维护成本很高。TaoToken 提供统一的 Key 和 API 通道你只需要在 OpenClaw 的配置里填一次 Base URL 和 Key后续换模型只需要改 Model ID 就行。2.1 获取 TaoToken API Key首先登录 TaoToken 控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。进入后找到 API Keys 管理页面创建一个新的 Key。创建时建议给 Key 起一个容易识别的名字比如 “openclaw-qq”方便后续管理。创建完成后复制这个 Key 并保存好。这个 Key 就是 OpenClaw 调用模型时的凭证后面配置环境变量和 OpenClaw 的模型通道时会用到。如果你需要查看 TaoToken 支持的模型列表和详细接入文档可以访问 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。文档里会列出当前可用的 Model ID你在 OpenClaw 配置里填写的 Model ID 需要和文档里的一致。2.2 安装 Node 环境OpenClaw 基于 Node 运行所以第一步是确保本机有 Node 环境。打开 PowerShell 或终端执行node -v npm -v如果能看到版本号输出说明 Node 已经安装好了。OpenClaw 一般要求 Node 18 或更高版本。如果版本太低建议去 Node 官网下载 LTS 版本重新安装。安装过程比较简单一路下一步即可这里不再展开。Node 安装完成后建议把 npm 的源设置为国内镜像这样后续安装依赖会快很多npm config set registry https://registry.npmmirror.com2.3 一键安装 OpenClawNode 环境就绪后在 PowerShell 中执行 OpenClaw 的安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex这个脚本会自动下载并安装 OpenClaw 的最新版本。安装完成后你可以用下面的命令验证是否安装成功openclaw --version如果能看到版本号说明 OpenClaw 已经安装好了。安装过程中如果遇到网络问题导致下载失败可以多试几次或者参考 OpenClaw 官方文档里的其他安装方式比如通过 npm 全局安装或 Docker 部署。安装完成后建议先运行一次openclaw plugins list查看当前自带的插件列表。不同版本的 OpenClaw 预装插件可能不一样这一步的目的是确认 QQ 插件是否已经存在。如果列表里没有 QQ 相关的插件就需要手动安装。3. 安装 QQ 插件并配置 OpenClaw 通道OpenClaw 本身是一个通用框架要接入 QQ 需要安装对应的插件。这一章会给出完整的插件安装命令、QQ 开放平台的配置步骤以及 OpenClaw 的通道配置片段。3.1 安装 QQ 插件先检查当前插件列表openclaw plugins list如果输出里没有 QQ 插件以管理员身份打开 cmd 或 PowerShell执行openclaw plugins install sliverp/qqbotlatest安装完成后再次检查openclaw plugins list看到 QQ 插件出现在列表中说明安装成功。如果安装过程中提示权限不足确认你是以管理员身份运行的终端。3.2 在 QQ 开放平台创建机器人打开 QQ 开放平台 https://q.qq.com/#/ 用你手机号绑定的 QQ 登录。首次使用需要完成开发者认证个人开发者选择个人类型填写相关信息即可。认证完成后进入机器人管理页面点击创建机器人。填写机器人名称、头像和描述信息。创建成功后点击机器人头像进入配置页面。这里有几个关键参数需要提前复制保存AppID机器人的唯一标识AppSecret机器人的密钥Token用于验证的令牌这些参数在后续配置 OpenClaw 通道时会用到。另外在配置页面里找到 IP 白名单设置把你的公网 IP 填进去。如果不确定公网 IP可以在浏览器搜索“IP”查看。接着进入沙箱配置点击添加成员把你的 QQ 号或其他测试账号加进去。这样在沙箱环境下这些账号才能和机器人交互。3.3 配置 OpenClaw 的 QQ 通道回到终端执行下面的命令把 QQ 机器人添加到 OpenClaw 的 Channel 中openclaw channels add --channel qqbot --token AppID:AppSecret注意把AppID和AppSecret替换成你在 QQ 开放平台保存的实际值。命令执行成功后OpenClaw 就多了一个 QQ 通道。接下来需要配置模型通道。OpenClaw 的配置文件通常位于用户目录下的.openclaw文件夹中。你可以直接编辑配置文件也可以通过openclaw onboard交互式配置。这里给出一个配置文件的片段示例路径为~/.openclaw/config.json{ models: { default: { provider: openai, baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken API Key, modelId: claude-sonnet-4-20250514 } }, channels: { qqbot: { enabled: true, appId: 你的AppID, appSecret: 你的AppSecret } } }这里有三件套需要确认Base URL 填https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那个 KeyModel ID 填 TaoToken 文档里列出的模型标识。这三个参数缺一不可否则模型调用会失败。如果你更习惯用 TOML 格式OpenClaw 也支持config.toml[models.default] provider openai baseUrl https://taotoken.net/api apiKey 你的TaoToken API Key modelId claude-sonnet-4-20250514 [channels.qqbot] enabled true appId 你的AppID appSecret 你的AppSecret配置文件修改完成后保存并关闭。3.4 重启 OpenClaw 服务配置变更后需要重启网关服务才能生效。执行openclaw gateway restart如果之前没有启动过网关可以用openclaw gateway start启动过程中终端会输出日志。注意观察有没有报错信息比如认证失败、通道连接失败等。如果一切正常你会看到 QQ 通道已连接的提示。4. 验证请求与成功结果配置完成后最重要的一步是验证整个链路是否跑通。这一章会给出从本地启动到 QQ 群内触发回复的完整验证动作。4.1 启动 OpenClaw 并检查通道状态首先确保网关服务正在运行openclaw gateway status如果显示 running说明服务正常。接着检查通道状态openclaw channels list你应该能看到 qqbot 通道处于 enabled 状态。如果通道显示 disabled 或 error需要回到配置文件检查 AppID 和 AppSecret 是否正确。4.2 在 QQ 中触发机器人回复打开手机 QQ扫描 QQ 开放平台机器人配置页面右侧的二维码。扫码后进入添加页面点击添加使用。如果你是沙箱成员应该能直接进入对话窗口。在对话框里发送一条测试消息比如你好帮我看看当前目录下有哪些文件如果一切配置正确OpenClaw 会收到这条消息调用 TaoToken 的 API 通道请求模型然后把执行结果返回给你。你会在 QQ 里看到机器人的回复。这个过程背后发生了这些事QQ 开放平台把消息推送给 OpenClaw 的 qqbot 通道OpenClaw 解析消息内容通过配置的模型通道Base URL 指向 TaoToken调用大模型模型返回结果后OpenClaw 再把回复通过 QQ 通道发回给你。4.3 验证模型调用是否走了 TaoToken如果你想确认模型调用确实走了 TaoToken 通道可以查看 OpenClaw 的运行日志。日志里会记录每次模型请求的 Base URL。执行openclaw logs --tail 50在输出中搜索taotoken.net如果能看到相关请求记录说明模型调用已经正确路由到 TaoToken。另外你也可以登录 TaoToken 控制台在用量统计页面查看 API 调用记录。每次 OpenClaw 触发模型请求都会在控制台留下记录。这是最直接的验证方式。4.4 在 QQ 群里测试除了私聊你还可以把机器人拉到 QQ 群里。在群聊中 机器人 并发送指令比如你的机器人 帮我总结一下今天的科技新闻机器人会在群里回复执行结果。群聊场景下建议先在小范围测试确认稳定后再推广到正式群。如果群聊中机器人没有响应检查两个地方一是 QQ 开放平台的沙箱配置里是否把群成员都添加了二是 OpenClaw 的 qqbot 通道配置里是否开启了群聊支持。有些版本默认只开启私聊需要在配置文件里显式开启群聊。5. 常见报错排查与修复对接过程中最容易卡在几个地方这一章把常见的报错和修复方法整理出来方便你对照排查。5.1 401 Unauthorized这是最常见的报错之一。终端日志里出现401 Unauthorized或invalid api key说明 TaoToken 的 API Key 配置有问题。检查步骤第一确认配置文件里的apiKey字段填的是你在 TaoToken 控制台创建的 Key而不是其他平台的 Key。第二确认 Key 没有过期或被删除。第三确认 Base URL 填的是https://taotoken.net/api不要多加斜杠或路径。如果确认无误仍然报 401尝试重新生成一个 Key 并更新配置文件然后重启网关。5.2 local proxy failed日志里出现local proxy failed或connection refused通常是网络层面的问题。检查本机是否能正常访问https://taotoken.net/api。可以在终端执行curl -I https://taotoken.net/api如果返回 200 或 401说明网络连通。如果超时或拒绝连接检查本机网络设置。注意不要使用任何非正规的网络代理工具保持直连即可。5.3 reading choices 报错日志里出现error reading choices或unexpected response format说明模型返回的数据格式和 OpenClaw 预期的不一致。这种情况通常是因为 Model ID 填错了。回到 TaoToken 文档确认你填写的 Model ID 在支持列表中。有些模型返回格式不同换一个兼容的 Model ID 即可。5.4 OAuth 相关报错如果日志里出现OAuth或token exchange failed这通常和 QQ 开放平台的认证有关。检查 AppID 和 AppSecret 是否匹配Token 是否填写正确。另外确认 IP 白名单里填的公网 IP 和当前主机 IP 一致。如果 IP 变了需要重新添加。5.5 QQ 机器人无响应如果 QQ 里发消息后机器人完全没反应按以下顺序排查先看 OpenClaw 网关是否在运行执行openclaw gateway status。再看 qqbot 通道是否 enabled执行openclaw channels list。然后检查 QQ 开放平台的沙箱配置确认你的账号在成员列表里。最后检查机器人是否处于上线状态在开放平台配置页面确认。5.6 配置文件路径确认不同操作系统下 OpenClaw 配置文件的路径可能不同。Windows 通常在C:\Users\你的用户名\.openclaw\macOS 和 Linux 在~/.openclaw/。如果你找不到配置文件执行openclaw config path这会输出当前配置文件的完整路径。确认你编辑的是正确的文件修改后记得重启网关。6. 统一 Key 管理后的日常使用与扩展跑通最小闭环之后你可以开始把 OpenClaw 用到日常场景里。这一章聊聊统一 Key 管理带来的便利以及一些实用的扩展方向。6.1 为什么统一 Key 管理更省心在没有统一通道之前如果你想让 OpenClaw 用不同的模型处理不同任务需要为每个模型单独申请 Key、单独配置。时间一长配置文件里一堆 Key管理起来很乱。通过 TaoToken 的统一 API 通道你只需要维护一个 Key换模型时只改 Model ID 就行。比如你想从 Claude 切换到另一个模型只需要把配置文件里的modelId改掉重启网关即可。Base URL 和 API Key 都不用动。这在需要频繁切换模型的场景下特别方便。如果你需要长期运行编码类或 Agent 类任务可以考虑 TaoToken 的 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它针对长时间、高频次的模型调用做了优化适合把 OpenClaw 当作日常生产力工具的用户。6.2 在 QQ 里用 OpenClaw 做更多事跑通之后你可以尝试这些实用场景定时任务让 OpenClaw 每天早上定时抓取指定网站的信息生成摘要后推送到 QQ。你只需要在 QQ 里发一条指令设置定时规则。文件处理通过 QQ 发送指令让 OpenClaw 读取本地 PDF 文件并提取关键内容然后把结果发回给你。适合在手机上不方便操作电脑时使用。群管理辅助把机器人拉到工作群设置关键词自动回复。比如有人问“报销流程”机器人自动从知识库里找到答案并回复。远程操作在 QQ 里发送指令让 OpenClaw 在你电脑上执行特定操作比如启动某个程序、整理特定文件夹。相当于把 QQ 变成了远程控制入口。6.3 模型切换与参数调整如果你发现当前模型在某些任务上表现不够好可以随时切换。打开配置文件修改modelId字段然后重启网关openclaw gateway restartTaoToken 文档里会列出当前支持的模型和对应的 Model ID。你可以根据任务类型选择需要强推理的用推理型模型需要快速响应的用轻量型模型。如果你在验证模型效果时想快速对比不同模型的输出可以直接用 TaoToken 的模型对话功能地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。在网页里切换模型发同样的 prompt对比结果后再决定 OpenClaw 里用哪个。6.4 安全与权限建议把 AI 智能体接入 QQ 后建议注意几点第一不要给机器人过高的系统权限避免误操作。第二群聊场景下设置好触发条件避免机器人被滥用。第三定期检查 TaoToken 控制台的用量确保没有异常调用。第四API Key 不要泄露配置文件不要提交到公开仓库。如果你需要管理多个 Key 或查看调用明细可以随时访问 TaoToken 的 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。在那里可以创建、删除、禁用 Key也可以查看每个 Key 的调用记录。整个链路跑通后你手里就有了一个能在 QQ 里随时呼唤的 AI 助手。后续的扩展就看你的想象力了。遇到配置问题优先检查三件套Base URL、API Key、Model ID。这三个对了大部分问题都能解决。