{
  "schemaVersion": "1.0",
  "item": {
    "slug": "telegram-chat-to-image",
    "name": "Telegram Chat To Image",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/reetyo/telegram-chat-to-image",
    "canonicalUrl": "https://clawhub.ai/reetyo/telegram-chat-to-image",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/telegram-chat-to-image",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=telegram-chat-to-image",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/chat_to_image.py"
    ],
    "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-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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-chat-to-image"
    },
    "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-chat-to-image",
    "agentPageUrl": "https://openagent3.xyz/skills/telegram-chat-to-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-chat-to-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-chat-to-image/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 Chat to Image",
        "body": "Converts Telegram chat exports into a long screenshot-style image with iOS-style bubble interface."
      },
      {
        "title": "v1.2.0 (2026-03-07)",
        "body": "建议: 长图发送优化 — 对于较长对话，建议打包为 ZIP 文件发送，避免 Telegram 图片压缩导致模糊"
      },
      {
        "title": "v1.1.0 (2026-03-01)",
        "body": "修复: 中文长文本换行问题 — 现在逐字符检查宽度，正确换行\n修复: 发件人显示问题 — 正确区分\"我\"(蓝色气泡)和其他人(灰色气泡+头像)\n新增: 显示每条消息的发件人名称"
      },
      {
        "title": "v1.0.0",
        "body": "初始版本"
      },
      {
        "title": "Prerequisites",
        "body": "```bash\npip install Pillow\n```"
      },
      {
        "title": "CLI",
        "body": "```bash"
      },
      {
        "title": "Basic usage",
        "body": "python3 scripts/chat_to_image.py --input result.json --output chat.png"
      },
      {
        "title": "Limit messages",
        "body": "python3 scripts/chat_to_image.py --input result.json --limit 50 --output chat.png"
      },
      {
        "title": "Custom font (for Chinese support)",
        "body": "python3 scripts/chat_to_image.py --input result.json --font /System/Library/Fonts/PingFang.ttc\n```"
      },
      {
        "title": "Getting Telegram Export",
        "body": "Open Telegram Desktop\nGo to the chat you want to export\nClick menu and Export chat history\nSelect JSON format\nChoose messages and export"
      },
      {
        "title": "Input Format",
        "body": "Expects Telegram Desktop JSON export format with messages array containing id, type, date, from, from_id, and text fields."
      },
      {
        "title": "Output",
        "body": "Generates a PNG image with:\n\n800px width\niOS-style bubble chat interface\nGray bubbles for others, blue for user messages\nCircular avatars with initials\nTimestamps (HH:MM format)\nProper text wrapping for long messages"
      },
      {
        "title": "Limitations",
        "body": "Images, stickers, and media are not rendered\nReply threads are not visually indicated\nOnly plain text messages are fully supported\nLarge exports may create very tall images"
      },
      {
        "title": "Handling Long Conversations",
        "body": "For long conversations that result in tall images (>2000px), consider:\n\nZIP Packaging: Pack the PNG into a ZIP file before sending to avoid Telegram's image compression\nzip chat.zip chat.png\n\nThen send the ZIP file as a document instead of an image.\n\n\nMessage Limits: Use --limit to generate partial exports if the full conversation is too long"
      },
      {
        "title": "Customization",
        "body": "Edit scripts/chat_to_image.py to adjust:\n\nWIDTH: Image width (default 800)\nMY_BUBBLE_COLOR: Your message color\nOTHER_BUBBLE_COLOR: Others message color\nFONT_SIZE, BUBBLE_PADDING: Layout spacing"
      }
    ],
    "body": "Telegram Chat to Image\n\nConverts Telegram chat exports into a long screenshot-style image with iOS-style bubble interface.\n\nChangelog\nv1.2.0 (2026-03-07)\n建议: 长图发送优化 — 对于较长对话，建议打包为 ZIP 文件发送，避免 Telegram 图片压缩导致模糊\nv1.1.0 (2026-03-01)\n修复: 中文长文本换行问题 — 现在逐字符检查宽度，正确换行\n修复: 发件人显示问题 — 正确区分\"我\"(蓝色气泡)和其他人(灰色气泡+头像)\n新增: 显示每条消息的发件人名称\nv1.0.0\n初始版本\nPrerequisites\n\n```bash pip install Pillow ```\n\nUsage\nCLI\n\n```bash\n\nBasic usage\n\npython3 scripts/chat_to_image.py --input result.json --output chat.png\n\nLimit messages\n\npython3 scripts/chat_to_image.py --input result.json --limit 50 --output chat.png\n\nCustom font (for Chinese support)\n\npython3 scripts/chat_to_image.py --input result.json --font /System/Library/Fonts/PingFang.ttc ```\n\nGetting Telegram Export\nOpen Telegram Desktop\nGo to the chat you want to export\nClick menu and Export chat history\nSelect JSON format\nChoose messages and export\nInput Format\n\nExpects Telegram Desktop JSON export format with messages array containing id, type, date, from, from_id, and text fields.\n\nOutput\n\nGenerates a PNG image with:\n\n800px width\niOS-style bubble chat interface\nGray bubbles for others, blue for user messages\nCircular avatars with initials\nTimestamps (HH:MM format)\nProper text wrapping for long messages\nLimitations\nImages, stickers, and media are not rendered\nReply threads are not visually indicated\nOnly plain text messages are fully supported\nLarge exports may create very tall images\nBest Practices\nHandling Long Conversations\n\nFor long conversations that result in tall images (>2000px), consider:\n\nZIP Packaging: Pack the PNG into a ZIP file before sending to avoid Telegram's image compression\n\nzip chat.zip chat.png\n\n\nThen send the ZIP file as a document instead of an image.\n\nMessage Limits: Use --limit to generate partial exports if the full conversation is too long\n\nCustomization\n\nEdit scripts/chat_to_image.py to adjust:\n\nWIDTH: Image width (default 800)\nMY_BUBBLE_COLOR: Your message color\nOTHER_BUBBLE_COLOR: Others message color\nFONT_SIZE, BUBBLE_PADDING: Layout spacing"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/reetyo/telegram-chat-to-image",
    "publisherUrl": "https://clawhub.ai/reetyo/telegram-chat-to-image",
    "owner": "reetyo",
    "version": "1.2.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/telegram-chat-to-image",
    "downloadUrl": "https://openagent3.xyz/downloads/telegram-chat-to-image",
    "agentUrl": "https://openagent3.xyz/skills/telegram-chat-to-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-chat-to-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-chat-to-image/agent.md"
  }
}