TG Channel Manager

工作流： scout → draft → human approves → publisher

执行说明

你的环境中已提供 python3 和 curl（在 requires.bins 中声明）。请使用 exec/bash 工具自行运行所有命令。切勿要求用户为你执行任何命令。

启动流程

加载本技能时，**首先执行预检（preflight check）**：

python3 {baseDir}/scripts/tgcm.py --workspace {workspace} check

预检完成后 —— 根据结果立即行动，不要提问：

• 全部显示 [ok] → 静默继续执行用户的任务
• [fail] Bot token → 向用户索取 bot token，并保存：tgcm.py config set bot-token 。不要询问 token 来源或提供选择项
• [warn] SEARXNG_URL → 向用户索取 URL，并保存：tgcm.py config set searxng-url 。可不提供该值继续执行 —— 此时 scout 功能不可用，但其余命令仍可正常运行
• [fail] Channel → 明确报告失败的频道名称及原因，并附上输出中提供的修复方法
• [warn] No channels → 提及该警告，但继续执行 —— 用户可能正准备初始化一个频道

通过 config set 保存的设置将持久化至 tgcm/.config.json，并被后续所有命令读取使用。

切勿就预检结果发起任何追问。只需准确报告问题所在，并直接给出输出中提示的修复命令。
若用户未明确指定任务，则仅报告预检状态，不得额外输出其他内容。

CLI 参考手册（完整命令列表 —— 不支持任何其他命令）

所有命令格式为：python3 {baseDir}/scripts/tgcm.py --workspace {workspace}

Bot token 自动解析顺序为：--bot-token 参数 → $BOT_TOKEN 环境变量 → openclaw.json（自动搜索）→ tgcm/.config.json。调用 tgcm.py get-id @username 时无需显式传入 --bot-token，脚本会自动查找。若自动检测失败，请手动保存一次：tgcm.py config set bot-token 。

频道名称校验正则表达式：^[a-z0-9][a-z0-9_-]{0,62}$。

快速参考

操作指南（Recipes）

查询频道 ID

python3 {baseDir}/scripts/tgcm.py get-id @username

Token 将自动查找。返回频道 ID、类型（type）和标题（title）。

连接一个频道

1. 获取 ID：python3 {baseDir}/scripts/tgcm.py get-id @username
2. python3 {baseDir}/scripts/tgcm.py --workspace {workspace} init
3. python3 {baseDir}/scripts/tgcm.py --workspace {workspace} bind --channel-id
4. 在 openclaw.json 中配置 skills.entries["tg-channel-manager"].config
5. 添加定时任务（参见 {baseDir}/references/cron-setup.md）

加载频道帖子（重建去重索引）

python3 {baseDir}/scripts/tgcm.py --workspace {workspace} fetch-posts

从频道的公开页面（t.me/s/）抓取帖子，并将其加入 content-index.json。
可选参数：--limit N（最多抓取页数，默认为 5），--dry-run（仅预览，不写入）。
前提条件：频道必须是公开的（即拥有 @username）。

查看频道 / 状态

• tgcm.py list
• tgcm.py info
• 队列内容：cat tgcm//content-queue.md

禁止事项

• 不得虚构命令 —— 上表所列为唯一支持的全部命令
• 不得直接发布帖子 —— 仅由 cron Publisher 执行发布
• 不得将 draft 状态改为 pending —— 仅限人工操作
• 起草前必须执行去重检查（dedup-check）
• 不得要求用户执行命令 —— 环境中已提供 python3 和 curl，请使用 exec/bash 自行执行
• 不得向用户索取 bot token 或环境变量 —— token 支持自动解析，check 命令会明确指出缺失项
• 预检（check）后不得向用户发起任何追问 —— 应直接报告错误及对应修复命令，不提供选项
• 不得询问“这是频道还是群组” —— get-id 返回的 type 字段已明确标识，本技能仅支持频道（channel）

数据目录结构

tgcm/
  channels.json            <- [{"name", "channelId", "status", "createdAt"}, ...]
  {channel-name}/
    channel.json           <- 单频道元数据
    content-index.json     <- 去重索引
    content-queue.md       <- 帖子队列

当 channelId 已设置且 status 为 "connected" 时，视为频道已绑定。

配置说明

参数从 openclaw.json → skills.entries["tg-channel-manager"] 中读取：

Telegram

限制与调度

内容

帖子样式

环境变量

路径解析规则

沙箱模式下（workspaceAccess: "none"），workspace 实际位于 ~/.openclaw/sandboxes，而非 ~/.openclaw/workspace。请始终使用相对于 CWD 的路径。

定时任务（cron）配置详见：{baseDir}/references/cron-setup.md。

队列格式

content-queue.md 中条目格式

### 
- **Status:** draft | pending
- **Rubric:**   (from config.rubrics)
- **Topic:** 
- **Source:**  (for news)
- **Text:**

状态说明：

• draft —— 待人工审核
• pending —— 已批准，等待发布

发布完成后，该条目将**从 content-queue.md 中移除**。

去重机制（Deduplication）

每次起草前 —— 必须执行去重检查：

python3 {baseDir}/scripts/dedup-check.py --base-dir  --topic "topic" --links "url1" "url2"

发布后 —— 将新帖加入索引：

python3 {baseDir}/scripts/dedup-check.py --base-dir  --add  --topic "topic" --links "url"

重建索引（通过 Telegram 搜索）：

python3 {baseDir}/scripts/dedup-check.py --base-dir  --rebuild --channel-id 

索引文件存储于 /content-index.json（或按频道存放：tgcm//content-index.json）。