qqbot-channel

name	qqbot-channel
description	QQ channel management skill. Use qqbot_channel_api to list guilds and channels, inspect members, publish posts, manage announcements, and work with schedules through the QQ Open Platform HTTP API with automatic token authentication.
metadata	{"openclaw":{"emoji":"📡","requires":{"config":"[Truncated]"}}}

QQ 频道 API 请求指导

qqbot_channel_api 是一个 QQ 开放平台 HTTP 代理工具，自动填充鉴权 Token。你只需要指定 HTTP 方法、API 路径、请求体和查询参数。

📚 详细参考文档

每个接口的完整参数说明、返回值结构和枚举值定义：

• references/api_references.md

---

🔧 工具参数

参数	类型	必填	说明
method	string	是	HTTP 方法：GET, POST, PUT, PATCH, DELETE
path	string	是	API 路径（不含域名），如 /guilds/{guild_id}/channels，需替换占位符为实际值
body	object	否	请求体 JSON（POST/PUT/PATCH 使用）
query	object	否	URL 查询参数键值对，值为字符串类型

基础 URL：https://api.sgroup.qq.com，鉴权头 Authorization: QQBot {token} 由工具自动填充。

---

⭐ 接口速查

频道（Guild）

操作	方法	路径	参数说明
获取频道列表	GET	/users/@me/guilds	query: before, after, limit(最大100)
获取频道 API 权限	GET	/guilds/{guild_id}/api_permission	—

子频道（Channel）

操作	方法	路径	参数说明
获取子频道列表	GET	/guilds/{guild_id}/channels	—
获取子频道详情	GET	/channels/{channel_id}	—
创建子频道	POST	/guilds/{guild_id}/channels	body: name*, type*, position*, sub_type, parent_id, private_type, private_user_ids, speak_permission, application_id
修改子频道	PATCH	/channels/{channel_id}	body: name, position, parent_id, private_type, speak_permission（至少一个）
删除子频道	DELETE	/channels/{channel_id}	⚠️ 不可逆

子频道类型（type）：0=文字, 2=语音, 4=分组(position≥2), 10005=直播, 10006=应用, 10007=论坛

成员（Member）

操作	方法	路径	参数说明
获取成员列表	GET	/guilds/{guild_id}/members	query: after(首次填0), limit(1-400)
获取成员详情	GET	/guilds/{guild_id}/members/{user_id}	—
获取身份组成员列表	GET	/guilds/{guild_id}/roles/{role_id}/members	query: start_index(首次填0), limit(1-400)
获取在线成员数	GET	/channels/{channel_id}/online_nums	—

公告（Announces）

操作	方法	路径	参数说明
创建公告	POST	/guilds/{guild_id}/announces	body: message_id, channel_id, announces_type(0=成员,1=欢迎), recommend_channels(最多3条)
删除公告	DELETE	/guilds/{guild_id}/announces/{message_id}	message_id 设 all 删除所有

论坛（Forum）— 仅私域机器人

操作	方法	路径	参数说明
获取帖子列表	GET	/channels/{channel_id}/threads	—
获取帖子详情	GET	/channels/{channel_id}/threads/{thread_id}	—
发表帖子	PUT	/channels/{channel_id}/threads	body: title*, content*, format(1=文本,2=HTML,3=Markdown,4=JSON，默认3)
删除帖子	DELETE	/channels/{channel_id}/threads/{thread_id}	⚠️ 不可逆
发表评论	POST	/channels/{channel_id}/threads/{thread_id}/comment	body: thread_author*, content*, thread_create_time, image

日程（Schedule）

操作	方法	路径	参数说明
创建日程	POST	/channels/{channel_id}/schedules	body: { schedule: { name*, start_timestamp*, end_timestamp*, jump_channel_id, remind_type } }
修改日程	PATCH	/channels/{channel_id}/schedules/{schedule_id}	body: { schedule: { name*, start_timestamp*, end_timestamp*, jump_channel_id, remind_type } }
删除日程	DELETE	/channels/{channel_id}/schedules/{schedule_id}	⚠️ 不可逆

提醒类型（remind_type）："0"=不提醒, "1"=开始时, "2"=5分钟前, "3"=15分钟前, "4"=30分钟前, "5"=60分钟前

* 表示必填参数

---

💡 调用示例

获取频道列表

{
  "method": "GET",
  "path": "/users/@me/guilds",
  "query": { "limit": "100" }
}

获取子频道列表

{
  "method": "GET",
  "path": "/guilds/123456/channels"
}

创建子频道

{
  "method": "POST",
  "path": "/guilds/123456/channels",
  "body": {
    "name": "新频道",
    "type": 0,
    "position": 1,
    "sub_type": 0
  }
}

获取成员列表（分页）