{
  "schemaVersion": "1.0",
  "item": {
    "slug": "macos-screenshot-telegram",
    "name": "MAC OS screenshot to telegram",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/hoyin258/macos-screenshot-telegram",
    "canonicalUrl": "https://clawhub.ai/hoyin258/macos-screenshot-telegram",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/macos-screenshot-telegram",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=macos-screenshot-telegram",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/screenshot-telegram.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-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/macos-screenshot-telegram"
    },
    "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/macos-screenshot-telegram",
    "agentPageUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram/agent",
    "manifestUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram/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": "1. Telegram Bot Token",
        "body": "搵 @BotFather on Telegram\nSend /newbot 創建新 bot\n拎個 bot token（好似 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）"
      },
      {
        "title": "2. 搵 Telegram Chat ID",
        "body": "個人 ID: 搵 @userinfobot 或者 forward message 俾 @userinfobot\nGroup ID: Forward 任何 message 俾 @userinfobot"
      },
      {
        "title": "3. OpenClaw Config",
        "body": "響你既 OpenClaw profile config 度加入：\n\n{\n  \"telegram\": {\n    \"botToken\": \"YOUR_BOT_TOKEN_HERE\",\n    \"allowFrom\": [\"YOUR_CHAT_ID\"]\n  }\n}"
      },
      {
        "title": "4. Profile Naming",
        "body": "記住你用既 profile 名（例如 main、rescue），之後用既時候補返上去。"
      },
      {
        "title": "macOS Screenshot to Telegram",
        "body": "This skill captures the macOS screen and sends it directly via Telegram Bot API."
      },
      {
        "title": "Workflow",
        "body": "Capture screenshot using macOS built-in command:\n/usr/sbin/screencapture -x <output-path>\n\n\n\nCopy to workspace (required - OpenClaw has security restriction):\ncp <source> <workspace>/screenshot.png\n\n\n\nSend via Telegram Bot API (bypasses buggy message tool):\nBOT_TOKEN=$(grep botToken <config-path> | sed 's/.*\"botToken\": *\"\\([^\"]*\\)\".*/\\1/')\ncurl -s -X POST \"https://api.telegram.org/bot${BOT_TOKEN}/sendPhoto\" \\\n  -F \"chat_id=<target-chat-id>\" \\\n  -F \"photo=@<workspace>/screenshot.png\""
      },
      {
        "title": "Required Parameters",
        "body": "When using this skill, ask the user for:\n\ntarget-chat-id: The Telegram chat ID to send to (e.g., user's ID for DM)\nprofile: The OpenClaw profile name (e.g., \"main\", \"rescue\")"
      },
      {
        "title": "How to Find Paths",
        "body": "Config file: ~/.openclaw-<profile>/openclaw.json\nWorkspace: ~/.openclaw/workspace-<profile>/\n\nFor example, if your profile is \"main\", paths would be:\n\nConfig: ~/.openclaw-main/openclaw.json\nWorkspace: ~/.openclaw/workspace-main/"
      },
      {
        "title": "Notes",
        "body": "The message tool in OpenClaw has a bug (#15541) that returns success but doesn't send media\nAlways use curl with Telegram Bot API directly for reliable media delivery\nThe screenshot must be copied to workspace first due to OpenClaw's allowed directory security restriction\nThis skill is profile-agnostic - just pass the correct profile name"
      }
    ],
    "body": "Setup (Prerequisites)\n1. Telegram Bot Token\n搵 @BotFather on Telegram\nSend /newbot 創建新 bot\n拎個 bot token（好似 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）\n2. 搵 Telegram Chat ID\n個人 ID: 搵 @userinfobot 或者 forward message 俾 @userinfobot\nGroup ID: Forward 任何 message 俾 @userinfobot\n3. OpenClaw Config\n\n響你既 OpenClaw profile config 度加入：\n\n{\n  \"telegram\": {\n    \"botToken\": \"YOUR_BOT_TOKEN_HERE\",\n    \"allowFrom\": [\"YOUR_CHAT_ID\"]\n  }\n}\n\n4. Profile Naming\n\n記住你用既 profile 名（例如 main、rescue），之後用既時候補返上去。\n\nmacOS Screenshot to Telegram\n\nThis skill captures the macOS screen and sends it directly via Telegram Bot API.\n\nWorkflow\n\nCapture screenshot using macOS built-in command:\n\n/usr/sbin/screencapture -x <output-path>\n\n\nCopy to workspace (required - OpenClaw has security restriction):\n\ncp <source> <workspace>/screenshot.png\n\n\nSend via Telegram Bot API (bypasses buggy message tool):\n\nBOT_TOKEN=$(grep botToken <config-path> | sed 's/.*\"botToken\": *\"\\([^\"]*\\)\".*/\\1/')\ncurl -s -X POST \"https://api.telegram.org/bot${BOT_TOKEN}/sendPhoto\" \\\n  -F \"chat_id=<target-chat-id>\" \\\n  -F \"photo=@<workspace>/screenshot.png\"\n\nRequired Parameters\n\nWhen using this skill, ask the user for:\n\ntarget-chat-id: The Telegram chat ID to send to (e.g., user's ID for DM)\nprofile: The OpenClaw profile name (e.g., \"main\", \"rescue\")\nHow to Find Paths\nConfig file: ~/.openclaw-<profile>/openclaw.json\nWorkspace: ~/.openclaw/workspace-<profile>/\n\nFor example, if your profile is \"main\", paths would be:\n\nConfig: ~/.openclaw-main/openclaw.json\nWorkspace: ~/.openclaw/workspace-main/\nNotes\nThe message tool in OpenClaw has a bug (#15541) that returns success but doesn't send media\nAlways use curl with Telegram Bot API directly for reliable media delivery\nThe screenshot must be copied to workspace first due to OpenClaw's allowed directory security restriction\nThis skill is profile-agnostic - just pass the correct profile name"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/hoyin258/macos-screenshot-telegram",
    "publisherUrl": "https://clawhub.ai/hoyin258/macos-screenshot-telegram",
    "owner": "hoyin258",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram",
    "downloadUrl": "https://openagent3.xyz/downloads/macos-screenshot-telegram",
    "agentUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram/agent",
    "manifestUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/macos-screenshot-telegram/agent.md"
  }
}