OpenClaw 对接 QQ 实战指南:让你的 AI 助手在 QQ 里随时待命

摘要：OpenClaw 接入 QQ，等于给 AI 智能体接入了中国用户最核心的"消息中枢"。本文详解 OpenClaw 对接 QQ 的完整流程，从前置准备、插件安装、QQ 开放平台认证，到配置验证，配合完整命令和截图指引，帮你把 AI 助手变成随时可在 QQ 呼唤的得力助手。

一、为什么要把 OpenClaw 接入 QQ？

OpenClaw 本身已经支持飞书、钉钉、Telegram、Discord 等多个平台。但对中国用户来说，QQ 有着不可替代的地位：

三大核心价值

场景示例：

• 上班路上，在 QQ 上让 AI 整理昨天的会议记录
• 在群里@AI 管理员，自动发送群规或定时通知
• 远程控制电脑：启动程序、整理文件、生成报表

二、前置准备

2.1 获取大模型 API Key

OpenClaw 需要大模型支持。本文使用百度千帆大模型（也可选择阿里云百炼、智谱等）。

步骤：

1. 访问 百度千帆控制台^[1]
2. 完成实名认证
3. 创建 API Key
4. 首次使用需充值少量额度（测试用量很少）

2.2 安装 Node.js

OpenClaw 基于 Node.js 开发，需要安装 Node.js v22+。

验证安装：

node -v# 输出：v22.x.x

2.3 安装 OpenClaw

Windows PowerShell：

iwr-useb https://openclaw.ai/install.ps1 | iex

或使用 npm：

npm config set registry https://registry.npmmirror.comnpm install -g openclaw@2026.3.7-beta.1

验证安装：

openclaw --version# 输出：2026.3.7-beta.1

三、安装 QQ 插件

3.1 检查当前插件

openclaw plugins list

如果列表中没有 QQ 插件，需要手动安装。

3.2 安装 QQ Bot 插件

管理员身份运行 CMD/PowerShell：

openclaw plugins install @sliverp/qqbot@latest

3.3 验证安装

openclaw plugins list

看到 @sliverp/qqbot 说明安装成功。

四、QQ 开放平台配置

4.1 开发者认证

1. 访问 QQ 开发者平台^[2]
2. 使用手机号绑定的 QQ 登录
3. 首次使用需完成开发者认证：
• 个人开发者选择"个人"
• 填写相关信息
• 提交审核（通常很快通过）

4.2 创建 QQ 机器人

1. 切换到"机器人"标签页
2. 点击"创建机器人"
3. 填写必要信息：
• 名称：如"AI 小助手"
• 头像：上传清晰的 Logo
• 描述：简要说明机器人功能

4.3 获取关键参数

创建成功后，点击机器人头像进入配置页面，记录以下参数：

⚠️ 重要：将 AppID 和 AppSecret 保存到安全位置（如密码管理器），后续配置需要。

4.4 配置 IP 白名单

1. 进入"开发设置" → "IP 白名单"
2. 添加你的主机公网 IP
3. 保存配置

获取公网 IP：

curl ifconfig.me

4.5 沙箱配置

1. 进入"沙箱配置"
2. 点击"添加成员"
3. 添加测试 QQ 号（你自己的 QQ）

五、OpenClaw 配置 QQ 机器人

5.1 添加 QQ Channel

管理员窗口执行：

openclaw channels add --channel qqbot --token "AppID:AppSecret"

替换说明：

• AppID：替换为你在 QQ 开放平台获取的 AppID
• AppSecret：替换为对应的 AppSecret
• 格式：AppID:AppSecret（中间用冒号连接）

成功输出：

✓ Channel qqbot added successfully

5.2 启动 OpenClaw 服务

openclaw gateway start

5.3 完成初始化配置

openclaw onboard

按提示依次选择：

1. 是否已有配置：选择"Yes"或已有配置
2. 选择大模型提供商：选择"百度千帆"（或其他你使用的）
3. 输入 API Key：粘贴之前获取的千帆 API Key
4. 选择模型：选择默认模型（如 ERNIE-Bot）
5. 选择 Channel：选择"QQ Bot"
6. Skills 配置：选择"跳过"（后续可单独配置）
7. 完成配置：选择最后一项

六、验证集成效果

6.1 QQ 后台验证

1. 回到 QQ 开发者平台
2. 找到"测试二维码"
3. 使用手机 QQ 扫码

6.2 添加机器人

1. 扫码后进入机器人详情
2. 点击"添加使用"
3. 机器人会出现在你的 QQ 联系人列表

6.3 测试对话

在 QQ 中给机器人发送消息：

你好

如果机器人回复，说明集成成功！

6.4 群聊测试（可选）

1. 将机器人拉入 QQ 群
2. 在群里@机器人发送指令：

   @AI 小助手 今天天气怎么样

七、核心应用场景

7.1 个人生产力提升

7.2 群聊智能管理

7.3 远程办公自动化

八、常见问题与解决方案

8.1 插件安装失败

问题：openclaw plugins install 报错

解决方案：

# 1. 检查 npm 权限sudochown -R $(whoami) /usr/local/lib/node_modules# 2. 重新安装npm config set registry https://registry.npmmirror.comopenclaw plugins install @sliverp/qqbot@latest

8.2 机器人无响应

可能原因：

• IP 白名单未配置
• AppID/AppSecret 错误
• 网关服务未启动

排查步骤：

# 1. 检查网关状态openclaw gateway status# 2. 查看日志openclaw logs --follow# 3. 验证 Channel 配置openclaw channels list

8.3 QQ 后台审核不通过

常见原因：

• 机器人描述过于简单
• 头像不清晰或违规
• 功能说明不明确

解决方案：

• 完善机器人描述（50 字以上）
• 使用清晰的 Logo 作为头像
• 详细说明机器人功能和使用场景

8.4 消息发送失败

可能原因：

• 大模型 API Key 无效
• 网络连接问题
• 消息格式不支持

排查步骤：

# 1. 验证 API Keyopenclaw configure --section models# 2. 测试大模型调用openclaw test-model# 3. 检查网络ping q.qq.com

九、高级配置（可选）

9.1 配置多个机器人

一个 QQ 账号最多可创建 5 个机器人。可为不同场景创建专属机器人：

# 个人助手openclaw channels add --channel qqbot --token "AppID1:Secret1" --name "personal-assistant"# 群管理员openclaw channels add --channel qqbot --token "AppID2:Secret2" --name "group-admin"# 客服机器人openclaw channels add --channel qqbot --token "AppID3:Secret3" --name "customer-service"

9.2 绑定特定 Agent

将 QQ 机器人与特定 Agent 绑定：

# 编辑配置文件nano ~/.openclaw/openclaw.json# 添加绑定规则{"bindings": [    {"agentId": "main","match": {"channel": "qqbot","peer": {"kind": "private","id": "你的 QQ 号"        }      }    },    {"agentId": "group-helper","match": {"channel": "qqbot","peer": {"kind": "group","id": "群号"        }      }    }  ]}# 重启网关openclaw gateway restart

9.3 自定义 Skills

为 QQ 机器人添加专属技能：

# 安装技能openclaw skills install <skill-name># 查看已安装技能openclaw skills list# 启用技能openclaw skills enable <skill-name>

十、总结

核心步骤回顾

总计：约 25 分钟完成全部配置

关键收获

1. 官方支持：腾讯官方提供一键创建机器人，流程简化
2. 零编程基础：只需执行几条命令即可完成绑定
3. 丰富交互：支持文本、Markdown、图片、语音、文件等多种格式
4. 全场景覆盖：个人助手、群管理、远程办公全部支持

下一步建议

1. 配置定时任务：让 AI 每天定时推送新闻摘要
2. 添加 Skills：安装文件整理、邮件处理等实用技能
3. 接入更多平台：同时配置飞书、钉钉，实现多渠道接入
4. 搭建多 Agent：为不同场景创建专属 AI Agent

⚠️ 风险提示

1. QQ 开放平台政策可能调整，请以官方最新文档为准
2. 大模型 API 调用会产生费用，注意监控用量
3. 群聊自动化功能需遵守群规，避免被举报
4. 敏感操作（如文件删除）需谨慎配置权限

版权声明：本文版权归 ScienceStudio 所有，未经许可禁止转载。

参考资料：

• OpenClaw 官方文档：https://docs.openclaw.ai^[3]
• QQ 开发者平台：https://q.qq.com/^[4]
• QQ Bot 插件：https://github.com/silverp/qqbot^[5]
• 百度千帆大模型：https://cloud.baidu.com/product/wenxinworkshop^[6]

把 AI 助手接入 QQ，让"聊天式调用 AI"成为日常。不需要学习新 App，在熟悉的聊天窗口里，@一下就能完成各种任务。这才是 AI 该有的样子。