跳转到主要内容
使用官方的 QQ 开放平台机器人 API 将 QQ（中国最流行的即时通讯应用）连接到您的 LemonClaw 实例。本指南适用于托管的 Claw 实例和私有部署的 LemonClaw。

​
先决条件

​
设置指南

1

创建 QQ 机器人应用

  1. 前往 QQ 开放平台
  2. 登录并前往 机器人 板块
  3. 点击 创建机器人
  4. 填写机器人信息（名称、头像、描述）
  5. 提交审核
2

获取凭据

  1. 审核通过后，前往机器人的 开发设置
  2. 复制 AppID
  3. 复制 AppSecret (Client Secret)
3

配置沙箱（用于测试）

  1. 在机器人设置中，前往 沙箱配置
  2. 将您的 QQ 号添加到沙箱白名单
  3. 这允许您在正式上线前进行测试
在提交生产审核之前，先使用沙箱模式验证一切功能正常。
4

打开 LemonClaw WebUI

  1. 如果您使用的是托管版 Claw，请前往您的 Claw Dashboard 并点击 Open WebUI
  2. 如果您是私有部署 LemonClaw，请打开您自己的 WebUI（例如 http://your-ip:18789）并使用您的 token 登录
  3. 在 WebUI 中，导航至 Settings → Channels
  4. 展开 QQ 板块
  5. 粘贴您的 AppID 和 AppSecret
  6. 点击 Save
5

开始聊天

  1. 在 QQ 中搜索您的机器人或将其添加为好友
  2. 发送一条消息
  3. 第一个用户将自动配对为所有者 —— 无需代码！
  4. 开始与 AI 聊天！

​
支持的消息类型

类型描述
C2C (私聊)直接向机器人发送消息
群聊 @提及在 QQ 群中 @机器人
当前 LemonClaw 的 QQ 支持范围是：私聊 和 群内 @机器人的事件。未 @ 的普通群消息，以及 QQ 频道（频道会话）目前都还没有接入。

​
故障排除

当前 LemonClaw 的 QQ 支持范围是私聊和群内 @ 机器人的事件。未 @ 的普通群消息，以及 QQ 频道会话，目前都还没有接入。
  • 验证 AppID 和 AppSecret 是否正确
  • 检查您的 QQ 号是否在沙箱白名单中（如果正在测试）
  • 确保机器人应用已通过审核
  • 仔细检查 AppID —— 它应该是一个数字字符串
  • 确保您使用的是正确的 AppSecret（而不是 token）