opencode/picoclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
picoclaw/docs/channels/qq
History
美電球 828971d549
Feat/qq local file upload (#1722) 
* feat(qq): support media uploads and inbound attachments

* docs(qq): document media size limit settings

* chore(web): add QQ media size limit hints

* fix(qq): demote botgo heartbeat logs

* style(qq): fix lint issues
2026-03-19 16:27:34 +08:00
..
README.zh.md Feat/qq local file upload (#1722) 2026-03-19 16:27:34 +08:00

README.zh.md

QQ

PicoClaw 通过 QQ 开放平台的官方机器人 API 提供对 QQ 的支持。

配置

{
  "channels": {
    "qq": {
      "enabled": true,
      "app_id": "YOUR_APP_ID",
      "app_secret": "YOUR_APP_SECRET",
      "allow_from": [],
      "max_base64_file_size_mib": 0
    }
  }
}
字段 类型 必填 描述
enabled bool 是 是否启用 QQ Channel
app_id string 是 QQ 机器人应用的 App ID
app_secret string 是 QQ 机器人应用的 App Secret
allow_from array 否 用户ID白名单，空表示允许所有用户
max_base64_file_size_mib int 否 本地文件转 base64 上传的最大体积，单位 MiB；0 表示不限制。仅影响本地文件，不影响 URL 直传

设置流程

  1. 前往 QQ 开放平台 创建一个机器人
  2. 通过仪表盘获取 App ID 和 App Secret
  3. 开启机器人沙箱模式, 将用户和群添加到沙箱中
  4. 将 App ID 和 App Secret 填入配置文件中