QQ 官方机器人 API 的 Moltbot 渠道插件，支持 C2C 私聊、群聊 @消息、频道消息。
多场景支持：C2C 单聊、QQ 群 @消息、频道公开消息、频道私信
自动重连：WebSocket 断连后自动重连，支持 Session Resume
消息去重：自动管理
msg_seq，支持对同一消息多次回复系统提示词：可配置自定义系统提示词注入到 AI 请求
错误提示：AI 无响应时自动提示用户检查配置
支持更加丰富的富文本消息
修复[health]检查提示: [health] refresh failed: Cannot read properties of undefined (reading 'appId')的问题（不影响使用）
解决了长时间使用会断联的问题
解决了频繁重连的问题
增加了大模型调用失败后的提示消息
解决了一些url会被拦截的问题
解决了多轮消息会发送失败的问题
修复了部分图片无法接受的问题
增加支持onboard的方式配置AppId 和 AppSecret
在插件目录下执行：
git clone https://github.com/sliverp/qqbot.git && cd qqbot
clawdbot plugins install . # 这一步会有点久，需要安装一些依赖。稍微耐心等待一下，尤其是小内存机器访问 QQ 开放平台
创建机器人应用
获取
AppID和AppSecret（ClientSecret）Token 格式为
AppID:AppSecret，例如102146862:Xjv7JVhu7KXkxANbp3HVjxCRgvAPeuAQ
clawdbot channels add# 选择 qqbot，按提示输入 Tokenclawdbot channels add --channel qqbot --token "AppID:AppSecret"示例：
clawdbot channels add --channel qqbot --token "102146862:xxxxxxxx"也可以直接编辑 ~/.clawdbot/clawdbot.json：
{ "channels": { "qqbot": { "enabled": true, "appId": "你的AppID", "clientSecret": "你的AppSecret", "systemPrompt": "你是一个友好的助手"
}
}
}| 配置项 | 类型 | 必填 | 说明 |
|---|---|---|---|
appId | string | 是 | QQ 机器人 AppID |
clientSecret | string | 是* | AppSecret，与 clientSecretFile 二选一 |
clientSecretFile | string | 是* | AppSecret 文件路径 |
enabled | boolean | 否 | 是否启用，默认 true |
name | string | 否 | 账户显示名称 |
systemPrompt | string | 否 | 自定义系统提示词 |
| 事件类型 | 说明 | Intent |
|---|---|---|
C2C_MESSAGE_CREATE | C2C 单聊消息 | 1 << 25 |
GROUP_AT_MESSAGE_CREATE | 群聊 @机器人消息 | 1 << 25 |
AT_MESSAGE_CREATE | 频道 @机器人消息 | 1 << 30 |
DIRECT_MESSAGE_CREATE | 频道私信 | 1 << 12 |
后台启动
clawdbot gateway restart前台启动, 方便试试查看日志
clawdbot gateway --port 18789 --verboseclawdbot onboard# 选择 QQ Bot 进行交互式配置消息回复限制：QQ 官方 API 限制每条消息最多回复 5 次，超时 60 分钟
URL 限制：QQ 平台不允许消息中包含 URL，插件已内置提示词限制
群消息：需要在群内 @机器人 才能触发回复
沙箱模式：新创建的机器人默认在沙箱模式，需要添加测试用户
如果需要升级插件，先运行升级脚本清理旧版本：
git clone https://github.com/sliverp/qqbot.git && cd qqbot
# 运行升级脚本（清理旧版本和配置）bash ./scripts/upgrade.sh# 重新安装插件clawdbot plugins install . # 这一步会有点久，需要安装一些依赖。稍微耐心等待一下，尤其是小内存机器# 重新配置clawdbot channels add --channel qqbot --token "AppID:AppSecret"# 重启网关clawdbot gateway restart升级脚本会自动：
删除
~/.clawdbot/extensions/qqbot目录清理
clawdbot.json中的 qqbot 相关配置
# 安装依赖npm install# 编译npm run build# 监听模式npm run devqqbot/ ├── index.ts # 入口文件 ├── src/ │ ├── api.ts # QQ Bot API 封装 │ ├── channel.ts # Channel Plugin 定义 │ ├── config.ts # 配置解析 │ ├── gateway.ts # WebSocket 网关 │ ├── onboarding.ts # CLI 配置向导 │ ├── outbound.ts # 出站消息处理 │ ├── runtime.ts # 运行时状态 │ └── types.ts # 类型定义 ├── scripts/ │ └── upgrade.sh # 升级脚本 ├── package.json └── tsconfig.json
支付宝微信扫一扫，打赏作者吧～本文链接：https://kinber.cn/post/6203.html 转载需授权！
推荐本站淘宝优惠价购买喜欢的宝贝:
您阅读本篇文章共花了： 