@cxyhhhhh/openclaw-qqbot 2.0.0-dev.202607101541 → 2.0.0-dev.202607101939

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,94 +0,0 @@
1
- # QQ 开放平台群接口参考
2
-
3
- > 鉴权和请求头由 `qqbot_platform_api` 工具自动处理,无需手动管理。
4
-
5
- ---
6
-
7
- ## 接口列表
8
-
9
- ### 1. 获取机器人群内状态
10
-
11
- - 方法:`GET`
12
- - 路径:`/v2/groups/{group_id}/bot_state`
13
-
14
- 响应参数:
15
-
16
- | 字段 | 类型 | 说明 |
17
- |------|------|------|
18
- | joined_at | string | 入群时间(RFC3339 格式) |
19
- | allow_proactive_msg | bool | 是否允许主动消息推送 |
20
- | recv_msg_setting | string | 接收消息设置:`all`、`only_mention`、`mention_and_context` |
21
- | member_role | string | 群成员角色:`member`、`owner`、`admin` |
22
-
23
- 响应示例:
24
-
25
- ```json
26
- {
27
- "join_timestamp": "2026-06-23T22:03:09+08:00",
28
- "allow_proactive_msg": true,
29
- "recv_msg_setting": "all",
30
- "member_role": "admin"
31
- }
32
- ```
33
-
34
- ---
35
-
36
- ### 2. 获取群成员信息
37
-
38
- - 方法:`GET`
39
- - 路径:`/v2/groups/{group_id}/members/{member_id}`
40
-
41
- 响应参数:
42
-
43
- | 字段 | 类型 | 说明 |
44
- |------|------|------|
45
- | union_openid | string | 用户在应用/开放平台下的统一标识 |
46
- | user_openid | string | 用户 openid |
47
- | username | string | 用户昵称(仅单个查询时返回) |
48
- | member_role | string | 群成员角色:`member`、`owner`、`admin` |
49
- | joined_at | string | 入群时间(RFC3339 格式) |
50
- | bot | bool | 是否为机器人账号 |
51
-
52
- 响应示例:
53
-
54
- ```json
55
- {
56
- "union_openid": "u_xxxxxxxx",
57
- "user_openid": "o_xxxxxxxx",
58
- "username": "张三",
59
- "member_role": "member",
60
- "joined_at": "2026-06-23T22:03:09+08:00",
61
- "bot": false
62
- }
63
- ```
64
-
65
- ---
66
-
67
- ### 3. 获取群基础信息
68
-
69
- - 方法:`GET`
70
- - 路径:`/v2/groups/{group_id}/info`
71
-
72
- 响应参数:
73
-
74
- | 字段 | 类型 | 说明 |
75
- |------|------|------|
76
- | group_openid | string | 群 openid |
77
- | group_name | string | 群名称 |
78
- | group_finger_memo | string | 群简介/群公告 |
79
- | group_class_text | string | 群分类文案 |
80
- | group_tags | array[] | 群标签列表 |
81
- | group_member_num | int | 群成员数量 |
82
-
83
- 响应示例:
84
-
85
- ```json
86
- {
87
- "group_openid": "G_123456789",
88
- "group_name": "技术交流群",
89
- "group_finger_memo": "专注于后端技术开发交流",
90
- "group_class_text": "技术-后端开发",
91
- "group_tags": ["技术交流", "后端开发", "QQ机器人"],
92
- "group_member_num": 1250
93
- }
94
- ```