文章来源：https://cloud.tencent.com/developer/article/2635190
使用浏览器访问 QQ 机器人注册页面：
https://q.qq.com/qqbot/openclaw/login.html
扫码登录并创建机器人
使用 QQ 扫描页面上的二维码进行登录
登录成功后，点击 「创建机器人」 按钮
根据提示完成机器人创建
保存凭证信息
安装 QQBot 插件
3.1 安装插件
在命令行中执行以下命令安装 OpenClaw 社区的 QQBot 插件：
$ openclaw plugins install @sliverp/qqbot@latest
安装过程说明：
插件会自动下载并安装
安装完成后会显示成功提示
3.2 验证插件安装
可以通过以下命令查看已安装的插件列表：
$ openclaw plugins list
确认 @sliverp/qqbot 插件已成功安装。
- 配置 QQ 频道
4.1 添加 QQ 频道
将新建的 QQ 机器人配置为 OpenClaw 的消息频道：
$ openclaw channels add --channel qqbot --token "${{AppID}}:${{AppSecret}}"
命令示例（请替换为您的实际凭证）：
$ openclaw channels add --channel qqbot --token "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890"
配置凭证
如果需要在配置文件中直接配置（可选），可以在 openclaw.json 中添加：
{
"channels": {
"qqbot": {
"enabled": true,
"token": "your-appid:your-appsecret"
}
}
}
安全提示： 建议通过命令行参数配置，避免在配置文件中明文存储凭证。
配置完成后，重启 OpenClaw Gateway 服务使配置生效：
$ openclaw gateway restart
重启成功后会显示：
服务端口信息
WebUI 访问地址
Token 认证信息
- 验证接入
5.1 检查服务状态
确认服务正常运行：
$ openclaw status
确保服务状态为 running/active。
5.2 测试对话功能
打开 QQ，使用创建的机器人账号
向机器人发送消息
确认能够收到 OpenClaw 的回复
多机器人配置
如果需要配置多个 QQ 机器人，可以使用不同的频道名称：
机器人 1
$ openclaw channels add --channel qqbot1 --token "${{AppID1}}:${{AppSecret1}}"
机器人 2
$ openclaw channels add --channel qqbot2 --token "${{AppID2}}:${{AppSecret2}}"
常见问题
Q1: 安装插件失败怎么办？
检查网络连接是否正常
确认 npm 源配置正确：
$ npm config set registry https://registry.npmmirror.com/
尝试重新安装：
$ openclaw plugins uninstall @sliverp/qqbot
$ openclaw plugins install @sliverp/qqbot@latest
添加频道提示凭证无效？
确认 AppID 和 AppSecret 格式正确
检查 AppSecret 是否正确（注意区分大小写）
如凭证遗忘，请在机器人管理页面重置
Q3: 重启服务后机器人无响应？
检查服务状态：
$ openclaw status
查看日志排查问题：
$ openclaw logs
确认机器人账号已登录（部分机器人需要保持在线状态）
如何更新机器人凭证？
先移除旧频道
$ openclaw channels remove qqbot
重新添加新凭证
$ openclaw channels add --channel qqbot --token "${{新AppID}}:${{新AppSecret}}"
重启服务
$ openclaw gateway restart
机器人回复消息很慢怎么办？
检查网络连接质量
确认 GPUNexus API 响应正常
考虑更换模型（参考使用手册.md中的模型配置）
如何完全卸载 QQ 机器人功能？
停止并移除频道
$ openclaw channels remove qqbot
卸载插件
$ openclaw plugins uninstall @sliverp/qqbot
重启服务
$ openclaw gateway restart
附录：完整配置示例
{
"meta": {
"lastTouchedVersion": "2026.2.1",
"lastTouchedAt": "2026-03-06T00:00:00.000Z"
},
"channels": {
"qqbot": {
"enabled": true,
"token": "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"prefix": ""
}
},
"models": {
"providers": {
"GPUNexus": {
"baseUrl": "https://api.gpunexus.com/v1",
"apiKey": "sk-XXXXXXXXXXXXX",
"api": "openai-completions",
"models": [
{
"id": "MiniMax-M2.1",
"name": "MiniMax-M2.1"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "GPUNexus/MiniMax-M2.1"
},
"workspace": "/home/neo/.openclaw/workspace"
}
},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "your-token-here"
}
}
}