Setup (Prerequisites)

1. Telegram Bot Token

1. 搵 @BotFather on Telegram
2. Send /newbot 創建新 bot
3. 拎個 bot token（好似 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）

2. 搵 Telegram Chat ID

• 個人 ID: 搵 @userinfobot 或者 forward message 俾 @userinfobot
• Group ID: Forward 任何 message 俾 @userinfobot

3. OpenClaw Config

響你既 OpenClaw profile config 度加入：

{
  "telegram": {
    "botToken": "YOUR_BOT_TOKEN_HERE",
    "allowFrom": ["YOUR_CHAT_ID"]
  }
}

4. Profile Naming

記住你用既 profile 名（例如 main、rescue），之後用既時候補返上去。

macOS Screenshot to Telegram

This skill captures the macOS screen and sends it directly via Telegram Bot API.

Workflow

1. Capture screenshot using macOS built-in command:

   /usr/sbin/screencapture -x \x3Coutput-path>
   

2. Copy to workspace (required - OpenClaw has security restriction):

   cp \x3Csource> \x3Cworkspace>/screenshot.png
   

3. Send via Telegram Bot API (bypasses buggy message tool):

   BOT_TOKEN=$(grep botToken \x3Cconfig-path> | sed 's/.*"botToken": *"\([^"]*\)".*/\1/')
   curl -s -X POST "https://api.telegram.org/bot${BOT_TOKEN}/sendPhoto" \
     -F "chat_id=\x3Ctarget-chat-id>" \
     -F "photo=@\x3Cworkspace>/screenshot.png"
   

Required Parameters

When using this skill, ask the user for:

• target-chat-id: The Telegram chat ID to send to (e.g., user's ID for DM)
• profile: The OpenClaw profile name (e.g., "main", "rescue")

How to Find Paths

1. Config file: ~/.openclaw-\x3Cprofile>/openclaw.json
2. Workspace: ~/.openclaw/workspace-\x3Cprofile>/

For example, if your profile is "main", paths would be:

• Config: ~/.openclaw-main/openclaw.json
• Workspace: ~/.openclaw/workspace-main/

Notes

• The message tool in OpenClaw has a bug (#15541) that returns success but doesn't send media
• Always use curl with Telegram Bot API directly for reliable media delivery
• The screenshot must be copied to workspace first due to OpenClaw's allowed directory security restriction
• This skill is profile-agnostic - just pass the correct profile name