前提条件
- 已在电脑上安装 SetupClaw 应用（macOS 或 Windows）
- 已在 q.qq.com（QQ 机器人开放平台）注册开发者账号
- 已设置 OpenClaw 并配置了至少一个 AI 模型
设置步骤
1
创建 QQ 机器人
前往 QQ 机器人开放平台 q.qq.com，使用开发者账号登录。
- 进入机器人管理页面，创建一个新的机器人应用。
- 机器人创建完成后，在机器人凭证页面找到应用 ID（App ID）和应用密钥（App Secret）。
- 妥善保存这些凭证——您将在第 4 步中使用它们。
2
配置机器人设置
设置机器人资料并启用必要的功能。
- 为机器人设置名称、头像和描述。这是用户与机器人交互时看到的内容。
- 启用消息接收功能，使机器人能够回复用户消息。
- 保存机器人配置后再继续下一步。
3
设置沙箱或正式模式
选择先在沙箱模式下测试，还是直接提交正式审核。
- 如需初步测试，请启用沙箱模式。这允许您在上线前使用有限的测试用户测试机器人。
- 当您对机器人的表现满意后，提交正式审核。
- 审核通过后，您的机器人将对所有 QQ 用户可用。
4
在 SetupClaw 中输入凭证
打开 SetupClaw 应用，将 QQ 添加为新渠道。
- 在 SetupClaw 应用中，进入「渠道」页面并点击「添加渠道」。
- 从可用渠道列表中选择「QQ」。
- 输入您在第 1 步中获取的应用 ID 和应用密钥。
- SetupClaw 将自动安装 QQ 机器人插件，并配置 allowFrom 以接受所有消息。
5
添加机器人并测试
在 QQ 中找到您的机器人并发送测试消息，验证集成是否成功。
- 在 QQ 中搜索您的机器人名称，将其添加为好友或邀请到群聊。
- 向机器人发送一条消息。
- 如果 AI 回复了消息，说明您的 QQ 集成已完成。
故障排除
机器人审核中
如果您的机器人仍处于沙箱模式，只有指定的测试用户可以与其交互。提交正式审核后即可对所有用户开放。
沙箱模式与正式模式混淆
在 QQ 机器人开放平台上仔细确认机器人当前处于哪种模式。在沙箱模式下，非测试用户的消息不会被推送给机器人。
消息未收到
确认 SetupClaw 应用中的 OpenClaw 网关正在运行。同时确认应用 ID 和应用密钥是否正确。尝试从 SetupClaw 仪表板重启网关。