{
  "schemaVersion": "1.0",
  "item": {
    "slug": "telegram-bot-manager",
    "name": "Telegram Bot Manager",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/362224222/telegram-bot-manager",
    "canonicalUrl": "https://clawhub.ai/362224222/telegram-bot-manager",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/telegram-bot-manager",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=telegram-bot-manager",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "QUICKSTART.md",
      "README.md",
      "RELEASE_NOTES.md",
      "SKILL.md",
      "metadata.json",
      "references/OPENCLAW_CONFIG.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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-bot-manager"
    },
    "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-bot-manager",
    "agentPageUrl": "https://openagent3.xyz/skills/telegram-bot-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-bot-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-bot-manager/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Setup a new Telegram bot",
        "body": "Create bot via BotFather\n\nMessage @BotFather on Telegram\nUse /newbot command\nFollow prompts for bot name and username\nCopy the bot token (format: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)\n\n\n\nConfigure in OpenClaw\n\nAdd token to OpenClaw config\nEnable Telegram plugin\nSet up pairing mode for DM access"
      },
      {
        "title": "Validate bot configuration",
        "body": "# Test Telegram API connectivity\ncurl -I https://api.telegram.org\n\n# Check bot token validity\ncurl -s \"https://api.telegram.org/bot<YOUR_TOKEN>/getMe\""
      },
      {
        "title": "Troubleshooting connectivity issues",
        "body": "When api.telegram.org is unreachable:\n\nCheck network access\ncurl -I -m 10 https://api.telegram.org\n\n\n\nVerify DNS resolution\nnslookup api.telegram.org\n\n\n\nTest alternative endpoints\ncurl -I https://telegram.org"
      },
      {
        "title": "Configuring OpenClaw Telegram integration",
        "body": "See OPENCLAW_CONFIG.md for detailed configuration steps."
      },
      {
        "title": "Bot token security",
        "body": "Never commit bot tokens to version control\nStore tokens in environment variables or secure config files\nRotate tokens if compromised\nUse different tokens for different environments (dev/prod)"
      },
      {
        "title": "Bot Commands Reference",
        "body": "Common Telegram bot commands for BotFather:\n\n/newbot - Create a new bot\n/mybots - Manage your bots\n/setdescription - Set bot description\n/setabouttext - Set about text\n/setuserpic - Set bot profile picture\n/setcommands - Set bot commands\n/token - Generate new token\n/revoke - Revoke current token\n/setprivacy - Configure privacy mode"
      },
      {
        "title": "Webhook (Recommended for production)",
        "body": "Bot receives updates via HTTP POST\nRequires public HTTPS endpoint\nMore efficient for high-volume bots"
      },
      {
        "title": "Polling (Good for development)",
        "body": "Bot continuously checks for updates\nSimpler setup, no public endpoint needed\nEasier to debug locally\n\nSee WEBHOOK_SETUP.md for webhook configuration."
      },
      {
        "title": "Common errors and solutions",
        "body": "\"Connection timed out\"\n\nCheck firewall rules\nVerify proxy configuration\nTest with different network\n\n\"Invalid token\"\n\nVerify token format (should contain colon)\nCheck for extra spaces or characters\nRegenerate token if needed\n\n\"Bot not responding\"\n\nVerify bot is not blocked\nCheck bot privacy settings\nEnsure bot has proper permissions"
      },
      {
        "title": "Manual testing",
        "body": "Search for your bot username on Telegram\nStart a conversation with /start\nTest basic commands"
      },
      {
        "title": "Automated testing",
        "body": "Use the test script in scripts/test_bot.py for automated validation."
      },
      {
        "title": "References",
        "body": "Telegram Bot API Documentation\nBotFather Documentation\nOpenClaw Configuration Guide"
      }
    ],
    "body": "Telegram Bot Manager\nQuick Start\nSetup a new Telegram bot\n\nCreate bot via BotFather\n\nMessage @BotFather on Telegram\nUse /newbot command\nFollow prompts for bot name and username\nCopy the bot token (format: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)\n\nConfigure in OpenClaw\n\nAdd token to OpenClaw config\nEnable Telegram plugin\nSet up pairing mode for DM access\nValidate bot configuration\n# Test Telegram API connectivity\ncurl -I https://api.telegram.org\n\n# Check bot token validity\ncurl -s \"https://api.telegram.org/bot<YOUR_TOKEN>/getMe\"\n\nCommon Workflows\nTroubleshooting connectivity issues\n\nWhen api.telegram.org is unreachable:\n\nCheck network access\n\ncurl -I -m 10 https://api.telegram.org\n\n\nVerify DNS resolution\n\nnslookup api.telegram.org\n\n\nTest alternative endpoints\n\ncurl -I https://telegram.org\n\nConfiguring OpenClaw Telegram integration\n\nSee OPENCLAW_CONFIG.md for detailed configuration steps.\n\nBot token security\nNever commit bot tokens to version control\nStore tokens in environment variables or secure config files\nRotate tokens if compromised\nUse different tokens for different environments (dev/prod)\nBot Commands Reference\n\nCommon Telegram bot commands for BotFather:\n\n/newbot - Create a new bot\n/mybots - Manage your bots\n/setdescription - Set bot description\n/setabouttext - Set about text\n/setuserpic - Set bot profile picture\n/setcommands - Set bot commands\n/token - Generate new token\n/revoke - Revoke current token\n/setprivacy - Configure privacy mode\nWebhook vs Polling\nWebhook (Recommended for production)\nBot receives updates via HTTP POST\nRequires public HTTPS endpoint\nMore efficient for high-volume bots\nPolling (Good for development)\nBot continuously checks for updates\nSimpler setup, no public endpoint needed\nEasier to debug locally\n\nSee WEBHOOK_SETUP.md for webhook configuration.\n\nError Handling\nCommon errors and solutions\n\n\"Connection timed out\"\n\nCheck firewall rules\nVerify proxy configuration\nTest with different network\n\n\"Invalid token\"\n\nVerify token format (should contain colon)\nCheck for extra spaces or characters\nRegenerate token if needed\n\n\"Bot not responding\"\n\nVerify bot is not blocked\nCheck bot privacy settings\nEnsure bot has proper permissions\nTesting Your Bot\nManual testing\nSearch for your bot username on Telegram\nStart a conversation with /start\nTest basic commands\nAutomated testing\n\nUse the test script in scripts/test_bot.py for automated validation.\n\nReferences\nTelegram Bot API Documentation\nBotFather Documentation\nOpenClaw Configuration Guide"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/362224222/telegram-bot-manager",
    "publisherUrl": "https://clawhub.ai/362224222/telegram-bot-manager",
    "owner": "362224222",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/telegram-bot-manager",
    "downloadUrl": "https://openagent3.xyz/downloads/telegram-bot-manager",
    "agentUrl": "https://openagent3.xyz/skills/telegram-bot-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-bot-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-bot-manager/agent.md"
  }
}