tencent-channel-community

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 / default / desc + 示例

环境与认证

最低 CLI 版本：1.0.6

tencent-channel-cli version          # 未安装或版本 < 1.0.6 → npm install -g tencent-channel-cli
tencent-channel-cli login status       # 未登录 → tencent-channel-cli login --json（取 verification_uri + qrcode_path 回显让用户扫码）→ tencent-channel-cli login poll-token --json
tencent-channel-cli doctor             # 自检连通性

tencent-channel-cli 不存在时必须先提示安装，禁止执行任何 tencent-channel-cli 命令。 CLI 版本低于 1.0.6 时，需要执行 npm install -g tencent-channel-cli 升级后再继续，禁止使用旧版本执行命令。

登录（扫码授权）

1. 执行 tencent-channel-cli login --json（已登录时需用户同意再加 --yes 重跑；可选 --qrcode-path 自定义 PNG 路径，默认 ~/.qqcli/login-qrcode.png）。
2. 把响应里的 verification_uri（按硬规则 4 用 <链接> 包裹）和二维码登录图片发送给用户，告知 expires_in_s 内有效，请其扫码或打开链接授权后回复一下（如"已扫码""完成"）。
3. 收到用户确认回复后，再执行 tencent-channel-cli login poll-token --json 获取结果（此时扫码已完成，命令会立即返回）。
4. 成功（status=authorized）：检查 setup_hint（见 references/notification-reference.md 第三节）；connectivity != "ok" 时告知用户凭证已存但服务暂不可达，不要重登。
5. 失败：错误含"过期/已被领取"回步骤 1 取新码；其他错误据消息告知用户。

禁止：编造 token、把 qr_code base64 直接打印给用户、用 login status 代替 poll-token。

更新检测

通过 HEAD 请求（不下载文件）读取响应头，判断 Skill 和 CLI 是否有新版本：

curl -sI -L https://connect.qq.com/skills/tencent-channel-community.zip
# 检查 x-cos-meta-tcc-version     → Skill 最新版本（与本文件 frontmatter version 比对）
# 检查 x-cos-meta-tcc-cli-version → 最新 CLI 版本（与 tencent-channel-cli version 比对）

$resp = Invoke-WebRequest -Method Head -MaximumRedirection 5 https://connect.qq.com/skills/tencent-channel-community.zip
$resp.Headers["x-cos-meta-tcc-version"]
$resp.Headers["x-cos-meta-tcc-cli-version"]

SKILL有新版本时，从以下渠道获取更新：

• CDN：https://connect.qq.com/skills/tencent-channel-community.zip
• GitHub：https://github.com/tencent-connect/tencent-channel-community
• ClawHub：https://clawhub.ai/tencent-adm/tencent-channel-community

执行阶段敏感信息策略

本节仅约束 Skill 的执行阶段：命令构造、链式调用、结果整理、最终回复。所有敏感信息先区分为“用户隐私数据”和“业务敏感数据”，再按以下规则处理。

1. 总原则

• 用户隐私数据：默认不展示、不复述、非执行必需不透传；若命令确需使用，仅保留最小必要字段
• 业务敏感数据：默认不向用户展示原值，但执行所需字段不得丢失，可在 Skill 内部链式调用中透传
• 能用内部 ID 或上下文字段完成定位时，禁止额外传递姓名、QQ号、手机号、邮箱、详细地址等个人信息
• 总结、表格、示例命令、resume 描述中，不得重新拼接、展开或推断完整敏感信息

2. 用户隐私数据

以下信息属于用户隐私数据（依据《个人信息保护法》第28条敏感个人信息分类）：

一般个人信息（默认不展示，脱敏后可提及）：

• 真实姓名
• 手机号、邮箱
• 详细地址（精确到街道/门牌）

敏感个人信息：

• 身份证号、护照号等身份证件号码
• 银行卡号、支付账户等金融账户信息
• 生物识别信息（人脸数据、指纹等）
• 医疗健康信息
• 行踪轨迹（精确位置信息）
• 未成年人（14周岁以下）的任何个人信息
• 宗教信仰、特定身份信息

登录凭证（最高保护级别，任何情况下不得展示、不得透传）：

• token、cookie、登录凭证

处理规则：

• 默认不在最终回复中展示原文，不在总结、表格、示例命令、resume 描述中回显
• 非执行必需不透传；命令确需使用时，仅保留最小必要字段
• 若必须提及，只允许脱敏或泛化表达，不给出完整值

3. 非面向用户字段

这些字段主要服务于 Skill 的内部执行和结果衔接，普通用户通常不需要理解或查看其原始值。：

• guild_id、channel_id、tiny_id
• feed_id、comment_id、reply_id
• author_id、target_user_id
• face_seq / avatar_seq、role_id、level_role_id
• channelInfo / channelSign、raw
• create_time_raw、attach_info / feed_attach_info / feed_attch_info / next_page_cookie

处理规则：

• 默认不向用户展示原值,用户并不理解,向用户说明时优先使用中文业务语义，不直接暴露内部字段值
• 允许在 Skill 内部链式调用中保留和透传

4. 默认摘要化展示

频道管理类：guild_id、channel_id、tiny_id、face_seq / avatar_seq、role_id、level_role_id、raw

内容管理类：feed_id、comment_id、reply_id、author_id、channelInfo / channelSign、create_time_raw

向用户提及上述概念时，使用以下中文名：guild_id→频道ID、channel_id→版块ID、tiny_id→用户ID、feed_id→帖子ID、comment_id→评论ID、reply_id→回复ID 优先使用“目标用户”“目标帖子”“目标频道”“已匹配到对应对象”等摘要化表达，不直接回显字段原值

6. 时间戳

• 内容管理命令：create_time 已格式化为北京时间（YYYY-MM-DD HH:MM:SS），直接展示；create_time_raw 为原始秒级时间戳，仅供链式操作使用，不展示
• 频道管理命令：原始秒级字段（如 joinTime、shutupExpireTime）自动附带 {字段名}_human 可读值，向用户展示 _human 字段，不展示原始时间戳；禁言时间戳为 0 时显示"无禁言"

快捷命令

当匹配下列意图时，优先使用快捷命令。一次调用替代多次 tool_call，提高处理速度。

意图	命令
搜索频道并加入	tencent-channel-cli manage search-and-join --keyword "<关键词>" --json
在频道内发帖	tencent-channel-cli feed quick-publish --content "<内容>" --json（含 Markdown 语法时改用 --markdown-content）
搜索帖子并评论	tencent-channel-cli feed search-and-comment --guild-id <ID> --query "<关键词>" --content "<评论>" --json
删帖并禁言	tencent-channel-cli feed delete-and-mute --guild-id <ID> --query "<关键词>" --json
获取最新帖子详情并且总结	tencent-channel-cli feed latest-feeds-detail --json
获取热门帖子详情并且总结	tencent-channel-cli feed hot-feeds-detail --json

快捷命令是多轮交互：返回 status: "waiting" 时不要放弃、不要改用单命令、不要误判为卡住，必须继续执行返回里的 resume_command。--resume-id 全程不变。

latest-feeds-detail 和hot-feeds-detail 默认返回的是帖子详情，需要再自行进行总结

交互协议示例

# Step 1: 发起快捷命令
tencent-channel-cli feed quick-publish --content "测试帖子" --json
# → {"data":{"status":"waiting","id":"s-abc12345","step":"1/5","pending":{"type":"pick","hint":"选择要发帖的频道","options":[...],"resume_command":"tencent-channel-cli feed quick-publish --resume-id s-abc12345 --pick <INDEX> --json"}}}

# Step 2: 选择选项后 resume
tencent-channel-cli feed quick-publish --resume-id s-abc12345 --pick 0 --json
# → {"data":{"status":"waiting",...}} 或 {"data":{"status":"done","result":{...}}}

重要：所有快捷命令调用必须加 --json flag。status: "done" 表示完成，status: "waiting" 表示必须继续 resume。 PowerShell：如果返回里的 resume_command 是裸命令，优先手动替换成 tencent-channel-cli ...（绝对路径或已加入 PATH）后再执行；不要尝试在同一个命令里交互式按键选择。