设置（前提条件）

1. Telegram Bot Token

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot 创建新 bot
3. 获取 bot token（例如：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）

2. 获取 Telegram Chat ID

• 个人 ID： 使用 @userinfobot，或转发一条消息给 @userinfobot
• 群组 ID： 转发任意一条消息给 @userinfobot

3. OpenClaw 配置

在你的 OpenClaw profile 配置文件中添加以下内容：

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

4. Profile 命名

请记住你所使用的 profile 名称（例如：main、rescue），后续调用时需将其填入相应参数。

macOS 截图并发送至 Telegram

该技能用于捕获 macOS 屏幕截图，并通过 Telegram Bot API 直接发送。

工作流程

1. 使用 macOS 内置命令截取屏幕：

   /usr/sbin/screencapture -x 
   

2. 复制到 workspace（必需步骤 —— OpenClaw 存在安全目录限制）：

   cp  /screenshot.png
   

3. 通过 Telegram Bot API 发送（绕过存在缺陷的 message 工具）：

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

必需参数

使用该技能时，请向用户索取以下参数：

• target-chat-id：目标 Telegram 聊天 ID（例如：私聊场景下为用户的个人 ID）
• profile：OpenClaw profile 名称（例如：main、rescue）

路径查找方法

1. 配置文件路径：~/.openclaw-/openclaw.json
2. Workspace 路径：~/.openclaw/workspace-/

例如，若你的 profile 名为 main，则对应路径为：

• 配置文件：~/.openclaw-main/openclaw.json
• Workspace：~/.openclaw/workspace-main/

注意事项

• OpenClaw 中的 message 工具存在缺陷（#15541）：调用后返回成功状态，但实际未发送媒体内容
• 为确保媒体可靠送达，请始终直接使用 curl 调用 Telegram Bot API
• 由于 OpenClaw 的允许目录安全限制，截图必须先复制到 workspace 目录中
• 本技能与 profile 无关，只需传入正确的 profile 名称即可