腾讯频道Skill
腾讯频道(QQ频道)社区管理 skill(CLI 版)。频道创建/设置/搜索/加入/退出,成员管理/禁言/踢人,帖子发布/编辑/删除/移动/搜索,评论/回复/点赞,版块管理,分享链接解析,频道私信,加入设置管理,内容巡检,问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。
Rank
62
Safety
84
Downloads
3.7k
Updated
Oct 9, 2026
Version
1.1.5
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 3.7K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 3.7K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.1.5release · observed Apr 29, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:tencent-channel-community- Install using `clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:tencent-channel-community` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/tencent-adm/tencent-channel-community before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencent-channel-community/snapshot"
Documentation
CLAWHUB
157,527 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: tencent-channel-community
description: 腾讯频道(QQ频道)社区管理 skill(CLI 版)。频道创建/设置/搜索/加入/退出,成员管理/禁言/踢人,帖子发布/编辑/删除/移动/搜索,评论/回复/点赞,版块管理,分享链接解析,频道私信,加入设置管理,内容巡检,问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。
homepage: https://connect.qq.com/ai
version: 1.1.5
metadata: {"openclaw":{"emoji":"📢"}}
---
所有操作通过 `tencent-channel-cli <domain> <action>` 调用。两种传参模式:
- **stdin JSON**:`echo '{"guild_id":"123"}' | tencent-channel-cli manage get-guild-info`
- **CLI flag**:`tencent-channel-cli manage get-guild-info --guild-id 123`
Windows / PowerShell 使用要求:
- 如果在执行过程中提示相关命令、依赖没有安装,可以先在powershell里执行`Get-Command`或者`where.exe`命令,查找并确认是否真的没有安装
- 执行`tencent-channel-cli`命令时,默认会使用`.ps1`脚本,但是windows可能默认的执行策略禁止运行`.ps1`脚本,会导致无交互的环境永久卡住,可以使用`.cmd`路径来调用
- 能用 flag 时优先用 flag;只有复杂对象、数组、分页透传等场景再用 stdin JSON,**PowerShell JSON格式**:`$body = @{ guild_id = "123" } | ConvertTo-Json -Compress; $body | & tencent-channel-cli manage get-guild-info --json`
请每天使用这个SKILL前检测下SKILL是否有更新,如果检测到有更新版,则询问用户是否需要更新
## 场景路由
根据用户意图关键词,读取对应参考文档:
- `**references/manage-guild.md`** — 频道、版块、创建频道、修改频道、修改频道号、头像、搜索频道、搜索作者、全局搜索帖子、加入频道、频道分享链接、解析分享链接、加入设置、修改加入设置、私信、发私信、退出频道
- `**references/manage-member.md`** — 成员、禁言、踢人、搜索成员、个人资料
- `**references/feed-reference.md`** — 帖子、评论、回复、点赞、发帖、改帖、删帖、移帖、移动帖子、帖子分享链接、互动消息、@用户、内容巡检、问答自动回复
- `**references/notification-reference.md`** — 消息通知、频道通知、开启通知、关闭通知、引用通知回复、login(setup_hint 处理)、subscribe_hint、daemon_guard、私信通知、系统通知
> 「帖子」「评论」「回复」「帖子分享链接」→ feed-reference.md;「频道分享链接」→ manage-guild.md;「消息通知」「通知」「开启通知」「关闭通知」「引用通知回复」→ notification-reference.md;「login 返回 setup_hint」→ notification-reference.md。
> 帖子搜索有两种:跨频道全局搜索(`search-guild-content scope=feed`)→ manage-guild.md;频道内搜索(`search-guild-feeds`)→ feed-reference.md。
## 全局硬规则
1. **@用户**:必须先 `guild-member-search` 或 `get-guild-member-list` 查到 `tiny_id`,填入 `at_users`(`id`=tiny_id, `nick`=昵称)。**严禁**在 content 中手写 `@昵称`,严禁用 QQ 号或猜测值
2. **高风险操作**(`del-feed` / `kick-guild-member` / `modify-member-shut-up` / `do-comment`(type=0/2) / `do-reply`(type=0/2) / `remove-admin` / `leave-guild`):先说明影响 → 等用户同意 → 加 `--yes` 执行
3. **执行阶段敏感信息最小化**:本 Skill 仅约束命令构造、链式调用、结果整理、最终回复四个执行阶段。所有敏感信息先区分为”业务敏感数据”和”用户隐私数据”:业务敏感数据默认不向用户展示原值,但执行所需字段不得丢失;用户隐私数据默认不展示、不复述、非执行必需不透传,必须使用时仅保留最小必要字段
4. **URL 输出**:必须用 `<链接>` 包裹(如 `<https://pd.qq.com/s/xxx>`),不用 markdown 语法
5. **鉴权失败**(retCode `8011` 或”未登录”错误):按"登录(扫码授权)"章节走,必须 `login --json` + `login poll-token --json` 两步,不得绕过扫码或编造 token;
6. **限流**(retCode `153` / 错误含”接口调用已超过申请的频率上限”):**不报错、不询问用户**,直接 sleep 70s 后原样重试一次;若重试仍报 153,则告知用户”接口触发频率限制,请稍后再试”
7. **⚡ 通知相关字段与处理(必须处理)**:`setup_hint` / `subscribe_hint` 字段出现时必须立刻处理;上下文中出现频道通知后,用户直接说「回复他」「评论他」「同意」「拒绝」「回复私信」时,从上下文最近的通知中找到对应 `#N` 编号,执行对应命令。详见 `references/notification-reference.md` 第三、五节。
## 链接识别
用户消息含 `pd.qq.com/s/<code>` 或 `pd.qq.com/...?inviteCode=<code>` → 先 `tencent-channel-cli manage get-share-info` 解析,再按意图继续。其他链接不走解析。
## 参数查询
参数定义和示例通过 CLI 实时查询(返回机器可解析的 JSON,比 --help 更适合 agent):
- `tencent-channel-cli schema <domain>.<action>` — flags 的 name / type / required / enum _meta.json
{
"ownerId": "kn77cw5hbmapf54rv89jdqwp7x835m4k",
"slug": "tencent-channel-community",
"version": "1.1.5",
"publishedAt": 1777458358032
}references/feed-reference.md
# 内容管理(feed) > **参数定义用 `tencent-channel-cli schema feed.<action>` 查,示例用 `--help` 看。本文档只写 schema 不体现的规则。** **关键提醒**:发帖/评论/回复涉及 @用户时,必须先查 `tiny_id` 填入 `at_users`,严禁在 content 中手写 `@昵称`(详见 SKILL.md 硬规则)。 ## 意图→命令速查 | 意图 | 命令 | 注意 | |------|------|------| | 浏览频道主页帖子 | `get-guild-feeds` | **不是** `get-channel-timeline-feeds`;必须传 `get_type` | | 浏览指定版块帖子 | `get-channel-timeline-feeds` | 需同时传 guild_id + channel_id | | 帖子详情 | `get-feed-detail` | 自动补取分享短链 | | 帖子评论 | `get-feed-comments` | 回复预览在 `replies_preview` 字段 | | 评论回复翻页 | `get-next-page-replies` | 首次 attach_info 从 get-feed-comments 评论对象获取 | | 搜索帖子 | `search-guild-feeds` | 结果补充频道名称与分享短链;**需已加入该频道**,否则报 retCode=130000 | | 互动消息 | `get-notices` | 类型: 1=顶帖 2=赞评论 3=赞回复 4=收到评论 5=收到回复 6=被@ | | 评论帖子 / "回复帖子" | `do-comment` | **禁止**用 do-reply 替代;删除时需 --yes;支持 `--ref` 从通知自动填充 | | 回复已有评论或回复 | `do-reply` | 需 comment_id,仅用于回复已有评论/回复;删除时需 --yes;支持 `--ref` 从通知自动填充 | | 发帖 | `publish-feed` | 见「发帖规则」 | | 删帖 | `del-feed` | 高风险,需 --yes | | 编辑帖子 / 改帖 | `alter-feed` | 自动补取分享短链;**Markdown 帖子可编辑**(用 `--markdown-content`,见「陷阱」) | | 帖子点赞 / 取消点赞 | `do-feed-prefer` | action: 1=点赞 3=取消 | | 评论/回复点赞 | `do-like` | like-type: 3=赞评论 4=取消 5=赞回复 6=取消;需 comment_id | | 精华/置顶 | `set-feed-essence` / `top-feed` | 需管理权限 | | 推送精华通知 | `push-essence-feed` | 每天限 3 次,每帖仅 1 次,需先加精 | | 移动帖子到其他版块 | `move-feed` | 需提供原版块 ID 和目标版块 ID | ## 核心规则 ### get-guild-feeds - **前置条件**:满足以下任一条件才可调用;否则告知用户并引导加入: - 该频道为**公开频道**(无需加入即可浏览) - 当前账号已是该频道的**成员**(可通过 `get-my-join-guild-info` 确认) - 不确定是否公开时,**直接执行**,报错再引导——返回 `retCode=20047` 时,告知用户该频道需先加入才能浏览,引导通过 `manage search-and-join` 加入后重试 - `get_type` **必须显式传入**,不传或传 0 返回空数据。1=热门 2=最新,不确定时默认 2 - 用户说"全部"/"所有帖子"/"按时间" → `get_type=2` - **翻页时必须保持相同 get_type**,游标与排序模式绑定 - 返回空列表(data 为空数组)→ 如实告知"暂无帖子数据",不切换其他工具重试 ### 发帖规则 1. **确认频道**:有 guild_id + channel_id → 直接发。没有 → **必须先问用户**是指定频道还是全局发帖;选指定频道 → 查 `get-my-join-guild-info` → 选频道 → 查 `get-guild-channel-list` → 排除非帖子类版块,找到「帖子广场」作为默认「全部」版块直接发帖。**严禁**未经确认走全局发帖 2. **全局发帖身份确认**:不传 guild_id/channel_id 时为「作者身份全局发帖」,要求账号具有「作者」角色,普通成员**无法**使用。执行前必须向用户确认其具有作者身份,确认后加 `--yes` 执行;未确认则引导用户传入 guild_id 和 channel_id 以普通成员身份发帖 3. **短贴 vs 长贴**:正文 ≤1000 加权字 → 短贴(feed_type=1)无需标题;>1000 → 长贴(feed_type=2)需标题。用户要求长贴时先索取标题。禁止未提供 title 时擅自用 feed_type=2。**加权字**:中文/中文标点=1字,英文/数字/半角=0.5字 4. **话题标签(#话题)**:仅**短贴**(feed_type=1)支持话题标签。**长贴(feed_type=2)不支持话题标签**。CLI 对长贴传入话题参数(`topic_names` / `--topic-name` / 正文中的 `#[话题]()` 语法)会直接报错拦截 5. **数量限制**:短贴 ≤1000字/≤18图/≤1视频;长贴 ≤10000字/≤50图/≤5视频;评论回复 ≤1图。超限 CLI 直接报错 6. **超限拆分**:严禁自行拆分发布,必须先告知用户 → 提出拆分方案 → 获得确认后执行 7. **内容格式(⚠️ 重要)**: - `--content` 是**纯文本模式**,后端不渲染任何 Markdown 语法——`##`、`**粗体**`、`- 列表`、`> 引用`、代码块等均原样显示为符号 - 内容含任何 Markdown 语法时,**必须改用 `--markdown-content`**(后端设置 `is_markdown=true`,客户端才会按 Markdown 渲染) - CLI 会在运行时检测 `--content` 里的 Markdown 语法并直接报错,引导改用 `--markdown-content` - `--content` 与 `--markdown-content` 互斥,不可同时传 8. 成功后自动补取分享短链,展示短链即可,**不返回 feed_id** ### 分享链接 - 帖子**列表**不自动补取短链,需要时调 `get-feed-share-url` - `get-feed-detail` / `pub
references/manage-guild.md
# 频道管理(manage-guild) > **参数用 `tencent-channel-cli schema manage.<action>` 查,示例用 `--help` 看。本文档只写 schema 不体现的规则。** ## 意图→命令速查 | 意图 | 命令 | 注意 | |------|------|------| | 我的频道列表 / 列出频道 / 查看已加入的频道 | `get-my-join-guild-info` | 返回三类:created / managed / joined(列表级摘要) | | 频道详情 / 频道详细信息 / 频道资料 / 成员数 / 公告 | `get-guild-info` | 返回成员数、公告、设置等详情;缺 guild_id → 先 `get-my-join-guild-info` 定位 | | 子版块列表 | `get-guild-channel-list` | 只查版块,不查帖子 | | 跨频道搜索频道/帖子/作者 | `search-guild-content` | scope: channel(默认) / feed / author / all;搜帖子用 scope=feed,频道内搜帖子用 feed 域 `search-guild-feeds` | | 频道分享链接 | `get-guild-share-url` | 仅频道链接,帖子链接用 feed 域 | | 解析分享链接 | `get-share-info` | 仅限 pd.qq.com 域名链接 | | 加入频道 | `join-guild` | 内部自动预检,见下文 | | 修改头像 | `upload-guild-avatar` | 需本地图片路径 | | 修改名称/简介 | `update-guild-info` | 可只改其一 | | 修改频道号 | `modify-guild-number` | 10~14 位英文/数字,需频道主权限;别和 `guild_id` 混淆 | | 创建频道 | `create-theme-private-guild` | 未指定私密则默认公开 | | 创建/删除/修改版块 | `create-channel` / `delete-channel` / `modify-channel` | delete 不可逆,高风险 | | 查看加入设置 | `get-join-guild-setting` | 返回加入方式类型及验证问题 | | 修改加入设置 | `update-join-guild-setting` | 6 种加入方式,高级类型需 stdin JSON | | 发送频道私信 | `push-group-dm-msg` | 对方未回复前只能发 1 条 | | 退出频道 | `leave-guild` | 不可逆,高风险,需 --yes | | **帖子类任务** | **→ feed-reference.md** | | | **成员类任务** | **→ manage-member.md** | | ### 分流误区 - "看频道有哪些帖子" → **feed-reference.md**,不是 manage - "查成员/禁言/踢人" → **manage-member.md** - "找频道"区分:搜未知频道 → `search-guild-content`,查已加入 → `get-my-join-guild-info` - **帖子搜索**区分:跨频道全局搜索帖子 → `search-guild-content scope=feed`;已知频道内搜索帖子 → feed 域 `search-guild-feeds` - **频道列表 vs 频道详情**:「列出我的频道」「我加入了哪些频道」→ `get-my-join-guild-info`(只返回名称、ID 等摘要);「查看某个频道的详细信息」「频道有多少成员」「频道公告是什么」→ 先定位 guild_id 再调 `get-guild-info`(返回成员数、公告、设置等完整详情)。**拿到列表后不要停下来**,如果用户意图是看详情,必须继续调 `get-guild-info` ## 频道创建规则 - `community_type`:`public`(默认)或 `private`,仅用户明确要求时传 `private` - 频道名称 ≤15 字;公开频道仅中英数,私密无限制;简介 ≤300 字符 - 需 `theme` 或 `guild_name` 至少其一 - 补取分享链接失败不回滚频道,在返回中给出告警 ## 加入频道规则 `join-guild` 内部自动预检加入设置,**无需**手动分两步。 | JoinGuildType | 含义 | AI 行为 | |---------------|------|---------| | 1 (DIRECT) | 直接加入 | 自动完成 | | 2 (ADMIN_AUDIT) | 管理员验证 | 返回 `need_verification` → 向用户收集附言 `join_guild_comment` → 再次调用 | | 3 (DISABLE) | 不允许 | 报错 | | 4/5 (QUESTION*) | 回答问题 | 返回问题 → 收集答案填入 `join_guild_comment` → 再次调用 | | 6 (MULTI_QUESTION) | 多题 | 返回问题列表 → 收集 `join_guild_answers`(⚡JSON) → 再次调用 | | 7 (QUIZ) | 测试题 | 返回选择题 → 收集 `join_guild_answers`(⚡JSON) → 再次调用 | > **收到 `need_verification` 必须先展示问题给用户、收集答案后才能再次调用。禁止自行编造答案。** ## 查询规则 - `get-my-join-guild-info` 返回 `created_guilds` / `managed_guilds` / `joined_guilds` 三类,用户说"我的频道"展示全部;前 10 个自动补取分享短链 - `search-guild-content` 的 `author` scope 搜的是「频道创作者」,**不是**帖子发布人也**不是**频道主;搜频道结果 ≤10 自动补取资料和短链 ## 加入设置规则 ### get-join-guild-setting 返回频道当前的加入方式(`joinType`)及对应验证问题/答题配置。可用于 `join-guild` 前判断需要提供哪些验证信息。 ### update-join-guild-setting 修改频道加入方式,需频道主/管理员权限。 | join-type 枚举 | 含义 | 是否需要 stdin JSON | |---------------|------|-------------------| | `JOIN_GUILD_TYPE_DIRECT` | 无需审核,直
references/manage-member.md
# 成员管理(manage-member)
> **参数用 `tencent-channel-cli schema manage.<action>` 查,示例用 `--help` 看。本文档只写 schema 不体现的规则。**
## 意图→命令速查
| 意图 | 命令 | 注意 |
|------|------|------|
| 成员列表 / 找管理员 / 查机器人 | `get-guild-member-list` | 返回 owners / admins / robots / members 四类,自动去重 |
| 按昵称搜成员 / 查 tiny_id | `guild-member-search` | **优先用这个**,比翻页遍历快 |
| 个人资料 | `get-user-info` | 见参数组合 |
| 禁言/解禁 | `modify-member-shut-up` | time_stamp=0 解禁,见陷阱 |
| 踢成员 | `kick-guild-member` | 高风险,需 --yes |
| 设置/移除管理员 | `add-admin` / `remove-admin` | 支持批量 tiny_ids;remove 高风险 |
| **频道类任务** | **→ manage-guild.md** | |
| **帖子类任务** | **→ feed-reference.md** | |
### 分流误区
- 只是找某人的 tiny_id → **优先** `guild-member-search`,不要翻页遍历成员列表
- `get-user-info` 查个人资料,`get-guild-member-list` 查频道成员列表,别混淆
## get-user-info 参数组合
| 传参 | 效果 |
|------|------|
| `{}` | 查自己全局资料 |
| `{guild_id}` | 查自己在频道内资料 |
| `{guild_id, tiny_id}` | 查他人在频道内资料 |
> `isGuildAuthor` = 频道创作者,**不是**帖子发布人也**不是**频道主
## 时间戳展示
原始秒级字段(如 `joinTime`、`shutupExpireTime`)自动附带 `{字段名}_human` 可读值,向用户展示 `_human` 字段,不展示原始时间戳。禁言时间戳为 `0` 时显示"无禁言"。
## 陷阱(schema 不体现)
| 陷阱 | 说明 |
|------|------|
| 禁言 time_stamp | 必须传**绝对 Unix 时间戳**(当前时间 + 时长秒数),不是时长。`0` = 立即解禁 |
| 批量踢人 | `tiny_id`(单个)和 `member_tinyids`(⚡JSON 批量)二选一 |
| 成员搜索翻页 | `--next-pos` 原样传回上一页返回值 |
| 成员列表翻页 | `next_page_token` 不透明令牌,必须原样传回 |AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/tencent-adm/skills/tencent-channel-community",
"sourceUrl": "https://clawhub.ai/tencent-adm/skills/tencent-channel-community",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T07:18:20.877Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencent-channel-community/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencent-channel-community/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T07:18:20.877Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "3.7K downloads",
"href": "https://clawhub.ai/tencent-adm/tencent-channel-community",
"sourceUrl": "https://clawhub.ai/tencent-adm/tencent-channel-community",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T07:18:20.877Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.1.5",
"href": "https://clawhub.ai/tencent-adm/tencent-channel-community",
"sourceUrl": "https://clawhub.ai/tencent-adm/tencent-channel-community",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T10:25:58.032Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencent-channel-community/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencent-channel-community/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.1.5",
"description": "tencent-channel-community v1.1.5 🚀 升级扫码授权登录流程,登录处理更清晰安全。 ✍️ 优化 Markdown 发帖与编辑说明,补充 Markdown 内容发布和 @ 用户规则。 🔔 更新通知订阅说明,重新登录或更换账号时会自动停止通知服务并清理本地订阅状态。 🚀 Updated the QR-code authorization login flow for clearer and safer authentication handling. ✍️ Improved Markdown publishing and editing guidance, including Markdown content and mention rules. 🔔 Updated notification subscription behavior: re-login or account switching now stops the daemon and clears local subscription state.",
"href": "https://clawhub.ai/tencent-adm/tencent-channel-community",
"sourceUrl": "https://clawhub.ai/tencent-adm/tencent-channel-community",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T10:25:58.032Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
