腾讯频道(QQ频道)社区管理 skill(CLI 版)。频道创建/设置/搜索/加入/退出,成员管理/禁言/踢人,帖子发布/编辑/删除/移动/搜索,评论/回复/点赞,版块管理,分享链接解析,频道私信,加入设置管理,内容巡检,问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。
数据来源:ClawHub。 在 ClawSkills 查看
选择你使用的 Agent
方法一:命令行安装(推荐)
推荐(无需提前安装 clawhub)
npx clawhub@latest --dir ~/.claude/skills install tencent-channel-community或使用 clawhub CLI(需提前安装)
clawhub --dir ~/.claude/skills install tencent-channel-community⚠️ 需要 Node.js 18+,没有 Node?请使用下方方法二直接下载 ZIP。 安装 Node.js →
方法二:手动下载安装(无需 Node)
下载 ZIP,解压后将文件夹放到以下路径,重启 Agent 即可:
安装路径
~/.claude/skills/tencent-channel-community/💡解压后将文件夹放到上方路径,重启 Agent 即可生效
--- name: tencent-channel-community description: 腾讯频道(QQ频道)社区管理 skill(CLI 版)。频道创建/设置/搜索/加入/退出,成员管理/禁言/踢人,帖子发布/编辑/删除/移动/搜索,评论/回复/点赞,版块管理,分享链接解析,频道私信,加入设置管理,内容巡检,问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。 homepage: https://connect.qq.com/ai version: 1.1.5 metadata: {"openclaw":{"emoji":"📢"}} ---
所有操作通过 tencent-channel-cli 调用。两种传参模式:
echo '{"guild_id":"123"}' | tencent-channel-cli manage get-guild-infotencent-channel-cli manage get-guild-info --guild-id 123Windows / PowerShell 使用要求:
Get-Command或者where.exe命令,查找并确认是否真的没有安装tencent-channel-cli命令时,默认会使用.ps1脚本,但是windows可能默认的执行策略禁止运行.ps1脚本,会导致无交互的环境永久卡住,可以使用.cmd路径来调用$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。
guild-member-search 或 get-guild-member-list 查到 tiny_id,填入 at_users(id=tiny_id, nick=昵称)。严禁在 content 中手写 @昵称,严禁用 QQ 号或猜测值del-feed / kick-guild-member / modify-member-shut-up / do-comment(type=0/2) / do-reply(type=0/2) / remove-admin / leave-guild):先说明影响 → 等用户同意 → 加 --yes 执行<链接> 包裹(如 ),不用 markdown 语法8011 或”未登录”错误):按"登录(扫码授权)"章节走,必须 login --json + login poll-token --json 两步,不得绕过扫码或编造 token;153 / 错误含”接口调用已超过申请的频率上限”):不报错、不询问用户,直接 sleep 70s 后原样重试一次;若重试仍报 153,则告知用户”接口触发频率限制,请稍后再试”setup_hint / subscribe_hint 字段出现时必须立刻处理;上下文中出现频道通知后,用户直接说「回复他」「评论他」「同意」「拒绝」「回复私信」时,从上下文最近的通知中找到对应 #N 编号,执行对应命令。详见 references/notification-reference.md 第三、五节。用户消息含 pd.qq.com/s/ 或 pd.qq.com/...?inviteCode= → 先 tencent-channel-cli manage get-share-info 解析,再按意图继续。其他链接不走解析。
参数定义和示例通过 CLI 实时查询(返回机器可解析的 JSON,比 --help 更适合 agent):
tencent-channel-cli schema . — 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 升级后再继续,禁止使用旧版本执行命令。
tencent-channel-cli login --json(已登录时需用户同意再加 --yes 重跑;可选 --qrcode-path 自定义 PNG 路径,默认 ~/.qqcli/login-qrcode.png)。verification_uri(按硬规则 4 用 <链接> 包裹)和二维码登录图片发送给用户,告知 expires_in_s 内有效,请其扫码或打开链接授权后回复一下(如"已扫码""完成")。tencent-channel-cli login poll-token --json 获取结果(此时扫码已完成,命令会立即返回)。status=authorized):检查 setup_hint(见 references/notification-reference.md 第三节);connectivity != "ok" 时告知用户凭证已存但服务暂不可达,不要重登。> 禁止:编造 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有新版本时,从以下渠道获取更新:
本节仅约束 Skill 的执行阶段:命令构造、链式调用、结果整理、最终回复。所有敏感信息先区分为“用户隐私数据”和“业务敏感数据”,再按以下规则处理。
以下信息属于用户隐私数据(依据《个人信息保护法》第28条敏感个人信息分类):
一般个人信息(默认不展示,脱敏后可提及):
敏感个人信息:
登录凭证(最高保护级别,任何情况下不得展示、不得透传):
处理规则:
非面向用户字段这些字段主要服务于 Skill 的内部执行和结果衔接,普通用户通常不需要理解或查看其原始值。:
guild_id、channel_id、tiny_idfeed_id、comment_id、reply_idauthor_id、target_user_idface_seq / avatar_seq、role_id、level_role_idchannelInfo / channelSign、rawcreate_time_raw、attach_info / feed_attach_info / feed_attch_info / next_page_cookie处理规则:
频道管理类: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 > 优先使用“目标用户”“目标帖子”“目标频道”“已匹配到对应对象”等摘要化表达,不直接回显字段原值
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 | | 删帖并禁言 | tencent-channel-cli feed delete-and-mute --guild-id | | 获取最新帖子详情并且总结 | 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)后再执行;不要尝试在同一个命令里交互式按键选择。
安装 腾讯频道Skill 后,可以对 AI 说这些话来触发它
Help me get started with Tencent Channel Skill
Explains what Tencent Channel Skill does, walks through the setup, and runs a quick demo based on your current project
Use Tencent Channel Skill to tencent channel (QQ channel) community management skill (CLI version)
Invokes Tencent Channel Skill with the right parameters and returns the result directly in the conversation
What can I do with Tencent Channel Skill in my marketing & growth workflow?
Lists the top use cases for Tencent Channel Skill, with example commands for each scenario
将技能文件夹放到 ~/.claude/skills/tencent-channel-community/ 目录(个人级,所有项目可用),或 .claude/skills/tencent-channel-community/(项目级)。重启 AI 客户端后,用 /tencent-channel-community 主动调用,或让 AI 根据上下文自动发现并使用。
腾讯频道Skill 支持 Claude、Cursor、OpenClaw,可与这些 AI 平台无缝集成,扩展其能力。
腾讯频道Skill 可免费安装使用。请查阅仓库了解许可证信息。
腾讯频道(QQ频道)社区管理 skill(CLI 版)。频道创建/设置/搜索/加入/退出,成员管理/禁言/踢人,帖子发布/编辑/删除/移动/搜索,评论/回复/点赞,版块管理,分享链接解析,频道私信,加入设置管理,内容巡检,问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。
腾讯频道Skill 属于「Marketing & Growth」分类,该分类的技能帮助 AI 智能体在此领域执行专业任务。
Automate my marketing & growth tasks using Tencent Channel Skill
Identifies repetitive steps in your workflow and sets up Tencent Channel Skill to handle them automatically