QQ 桥接

通过 QQ Bot 与 Claude 对话。支持图片发送和私聊桥接。

创建 QQ Bot

1. 前往 QQ 开放平台，注册开发者账号
2. 创建一个新的 Bot 应用
3. 完成实名认证（个人或企业）
4. 在应用管理页面获取：
   • AppID（数字格式）
   • App Secret
5. 在 功能配置 中开启需要的消息权限
6. 提交审核，等待通过

QQ Bot 平台审核较严格，建议仔细阅读平台文档中的接入规范。

在 CodePilot 中配置

1. 点击侧边栏 桥接，切换到 QQ 页面
2. 填写 App ID 和 App Secret
3. 点击 测试连接 验证凭据
4. （可选）配置 允许的用户 — 填写 QQ user_openid，多个用逗号分隔
5. （可选）配置图片设置：
   • 启用图片发送 — 允许 Bot 发送图片（默认开启）
   • 最大图片大小 — 单张图片大小限制（默认 20MB）
6. 点击 保存

启用桥接

1. 回到桥接总览页面
2. 确保 QQ 渠道开关已打开
3. 确保桥接主开关已开启
4. 点击 启动
5. 在 QQ 中添加 Bot 为好友，发送消息即可与 Claude 对话

消息格式

QQ 桥接以纯文本格式发送消息：

• 不支持 Markdown 渲染
• 超长消息自动分片（每片最大 2000 字符）
• 每条回复最多发送 3 个分片（平台限制）
• 支持发送图片（需开启图片设置）

权限处理

QQ Bot 平台不支持内联按钮，权限确认通过文本命令处理：

• Bot 发送权限确认消息，包含操作说明和权限 ID
• 你回复 /perm allow <ID> 允许操作
• 你回复 /perm deny <ID> 拒绝操作
• 你回复 /perm allow_session <ID> 允许本次会话内同类操作

故障排除

测试连接失败

1. 确认 App ID 和 App Secret 正确
2. 确认 Bot 应用已通过审核
3. 确认开发者实名认证已完成

Bot 不响应

1. 确认已添加 Bot 为 QQ 好友
2. 确认 CodePilot 桥接已启动
3. 如果设置了允许用户列表，确认你的 user_openid 在列表中

消息被截断

QQ 平台限制每条回复最多 3 个分片。对于特别长的回复，可能会丢失末尾部分。建议在提示中要求 Claude 简洁回复。