{
  "schemaVersion": "1.0",
  "item": {
    "slug": "telegram-auto-topic",
    "name": "Telegram Auto Topic",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/itstauq/telegram-auto-topic",
    "canonicalUrl": "https://clawhub.ai/itstauq/telegram-auto-topic",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/telegram-auto-topic",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=telegram-auto-topic",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/telegram-auto-topic.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/telegram-auto-topic"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/telegram-auto-topic",
    "agentPageUrl": "https://openagent3.xyz/skills/telegram-auto-topic/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-auto-topic/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-auto-topic/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Telegram Auto-Topic",
        "body": "Add /topic to the start of any message in a Telegram forum group → a new topic is created from it. The title is figured out from your message automatically — no need to think of one yourself."
      },
      {
        "title": "Example",
        "body": "1. You send a message starting with /topic:\n\n/topic @your_bot I need to look into renewing my passport before March\n\n2. A new forum topic \"Passport Renewal Before March\" is created with your message quoted inside it. You get a reply linking directly to the new topic."
      },
      {
        "title": "Prerequisites",
        "body": "The group must be configured in OpenClaw (channels.telegram.groups.<CHAT_ID>) — this is how OpenClaw knows to process messages from it.\nThe group must have forum/topics enabled.\nYour bot must be an admin in the group with Manage Topics permission."
      },
      {
        "title": "Handling /topic",
        "body": "When a message starts with /topic:\n\nGenerate a concise 3-7 word title summarising the message.\nRun the script — replace placeholders with actual values from the message context:\nscripts/telegram-auto-topic.sh <chat_id> <message_id> \"<sender name>\" \"<title>\" \"<text after /topic>\"\n\nPass an empty string for the text arg if there's no text (e.g. media-only).\nUse the path relative to this skill's directory.\nThe script returns JSON with topic_id, title, and link.\nReply to the original message with: Topic created → [<title>](<link>)\nThen send a response to the actual message content in the NEW topic (use message tool with threadId from the returned topic_id). Respond naturally as you would to any message.\nAfter both replies are sent, respond with NO_REPLY."
      },
      {
        "title": "How It Works",
        "body": "You send a message starting with /topic\nA new forum topic is created — titled from your message automatically\nYour message is quoted in the new topic with your name\nYou get a reply with a clickable link to the new topic\nThe bot responds to your message in the new topic\n\nWorks with media too — photos, videos, or documents with /topic in the caption get forwarded into the new topic."
      },
      {
        "title": "Script Reference",
        "body": "scripts/telegram-auto-topic.sh <chat_id> <message_id> <sender> [title] [text]\n\nParameterTypeRequiredDescriptionchat_idargyesSupergroup chat ID (negative number)message_idargyesOriginal message to quotesenderargyesDisplay name of original sendertitleargnoTopic title. Falls back to first ~50 chars of text if omittedtextargnoMessage body after /topic. If empty, forwards as media\n\nReturns JSON: {\"topic_id\": 123, \"title\": \"Used title\", \"link\": \"https://t.me/c/...\"}"
      },
      {
        "title": "Optional configuration",
        "body": "Skip the @bot mention — by default, the bot only responds when mentioned. To use /topic without mentioning the bot:\n\n\"channels.telegram.groups.<CHAT_ID>\": {\n  \"requireMention\": false\n}\n\nTelegram autocomplete — to get /topic in Telegram's command menu, add under channels.telegram:\n\n{\n  \"customCommands\": [\n    {\n      \"command\": \"topic\",\n      \"description\": \"Create a new forum topic from a message\"\n    }\n  ]\n}"
      },
      {
        "title": "Limitations",
        "body": "Attribution: Quoted messages appear as sent by the bot (Telegram API limitation). Sender name is included as attribution text below the quote.\nMedia: Forwarded media shows a \"Forwarded from\" header — best available but not native.\nForum groups only: Won't work in regular groups or DMs.\nPermissions: Bot needs admin with Manage Topics.\nTitle length: Telegram caps topic names at 128 characters."
      }
    ],
    "body": "Telegram Auto-Topic\n\nAdd /topic to the start of any message in a Telegram forum group → a new topic is created from it. The title is figured out from your message automatically — no need to think of one yourself.\n\nExample\n\n1. You send a message starting with /topic:\n\n/topic @your_bot I need to look into renewing my passport before March\n\n2. A new forum topic \"Passport Renewal Before March\" is created with your message quoted inside it. You get a reply linking directly to the new topic.\n\nPrerequisites\nThe group must be configured in OpenClaw (channels.telegram.groups.<CHAT_ID>) — this is how OpenClaw knows to process messages from it.\nThe group must have forum/topics enabled.\nYour bot must be an admin in the group with Manage Topics permission.\nHandling /topic\n\nWhen a message starts with /topic:\n\nGenerate a concise 3-7 word title summarising the message.\nRun the script — replace placeholders with actual values from the message context:\nscripts/telegram-auto-topic.sh <chat_id> <message_id> \"<sender name>\" \"<title>\" \"<text after /topic>\"\n\nPass an empty string for the text arg if there's no text (e.g. media-only). Use the path relative to this skill's directory.\nThe script returns JSON with topic_id, title, and link.\nReply to the original message with: Topic created → [<title>](<link>)\nThen send a response to the actual message content in the NEW topic (use message tool with threadId from the returned topic_id). Respond naturally as you would to any message.\nAfter both replies are sent, respond with NO_REPLY.\nHow It Works\nYou send a message starting with /topic\nA new forum topic is created — titled from your message automatically\nYour message is quoted in the new topic with your name\nYou get a reply with a clickable link to the new topic\nThe bot responds to your message in the new topic\n\nWorks with media too — photos, videos, or documents with /topic in the caption get forwarded into the new topic.\n\nScript Reference\nscripts/telegram-auto-topic.sh <chat_id> <message_id> <sender> [title] [text]\n\nParameter\tType\tRequired\tDescription\nchat_id\targ\tyes\tSupergroup chat ID (negative number)\nmessage_id\targ\tyes\tOriginal message to quote\nsender\targ\tyes\tDisplay name of original sender\ntitle\targ\tno\tTopic title. Falls back to first ~50 chars of text if omitted\ntext\targ\tno\tMessage body after /topic. If empty, forwards as media\n\nReturns JSON: {\"topic_id\": 123, \"title\": \"Used title\", \"link\": \"https://t.me/c/...\"}\n\nOptional configuration\n\nSkip the @bot mention — by default, the bot only responds when mentioned. To use /topic without mentioning the bot:\n\n\"channels.telegram.groups.<CHAT_ID>\": {\n  \"requireMention\": false\n}\n\n\nTelegram autocomplete — to get /topic in Telegram's command menu, add under channels.telegram:\n\n{\n  \"customCommands\": [\n    {\n      \"command\": \"topic\",\n      \"description\": \"Create a new forum topic from a message\"\n    }\n  ]\n}\n\nLimitations\nAttribution: Quoted messages appear as sent by the bot (Telegram API limitation). Sender name is included as attribution text below the quote.\nMedia: Forwarded media shows a \"Forwarded from\" header — best available but not native.\nForum groups only: Won't work in regular groups or DMs.\nPermissions: Bot needs admin with Manage Topics.\nTitle length: Telegram caps topic names at 128 characters."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/itstauq/telegram-auto-topic",
    "publisherUrl": "https://clawhub.ai/itstauq/telegram-auto-topic",
    "owner": "itstauq",
    "version": "0.1.8",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/telegram-auto-topic",
    "downloadUrl": "https://openagent3.xyz/downloads/telegram-auto-topic",
    "agentUrl": "https://openagent3.xyz/skills/telegram-auto-topic/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-auto-topic/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-auto-topic/agent.md"
  }
}