QQ 机器人

腾讯 QQ 于 2026-03-07 正式开放 OpenClaw 原生集成。QQ 机器人个人免费、一键创建、无需编码，是目前所有平台中接入难度最低的选择。

预计耗时

完成全部配置约需 5 分钟。

接入步骤

第一步：注册 QQ 开放平台

1. 访问 QQ 开放平台 OpenClaw 集成页面
2. 使用手机 QQ 扫码完成注册

第二步：创建机器人

1. 在 QQ 开放平台控制台中点击 创建机器人
2. 填写机器人名称和描述
3. 创建完成后，获取以下凭证：
   • AppID
   • AppSecret

Token 格式

QQ 机器人的 Token 格式为 AppID:AppSecret，中间用英文冒号分隔。例如：102012345:a1b2c3d4e5f6g7h8

第三步：安装 QQBot 插件

openclaw plugins install @sliverp/qqbot@latest

第四步：配置频道

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

将 AppID 和 AppSecret 替换为你在第二步获取的实际值。

第五步：重启 Gateway

openclaw gateway restart

启动后，在 QQ 中找到你的机器人，发送一条消息验证是否正常回复。

高级方案：NapCat

如果你需要使用 QQ 个人号（而非官方机器人）进行更灵活的集成，可以考虑 NapCat 框架。

NapCat 适合以下场景：

• 需要以个人号身份收发消息
• 需要访问更多 QQ 功能（如群管理、好友列表等）
• 需要更细粒度的消息控制

NapCat 注意事项

NapCat 使用非官方接口，存在一定的账号风险。建议使用小号进行测试，不要使用主力账号。

故障排查

机器人无响应？

1. 检查 Gateway 状态：

   openclaw gateway status

2. 检查频道连接状态：

   openclaw channels status

3. 确认 Token 格式正确：必须是 AppID:AppSecret 格式，用英文冒号分隔

提示"Token 无效"？

• 确认 AppID 和 AppSecret 复制完整，没有多余的空格
• 确认冒号是英文冒号 : 而非中文冒号 ：

插件安装失败？

openclaw plugins list

确认网络连接正常，如有必要可尝试使用国内镜像源重新安装。