MAC OS screenshot to telegram

在 macOS 上截取屏幕并发送到 Telegram。当用户请求截取屏幕、拍摄截图或发送屏幕截图时使用。

安装

概览

在 macOS 系统上,快速截取屏幕并自动发送到 Telegram 已成为许多开发者和远程工作者的刚需。OpenClaw 生态中推出的 “macOS Screenshot to Telegram” 技能正是为此场景量身打造的功能模块。该工具通过调用系统内置的 screencapture 命令实现高效截图,并利用 Telegram Bot API 将图片直接推送到指定聊天窗口,整个过程无需手动操作,极大提升了工作效率。尤其适用于需要远程协作、故障排查或实时汇报的场景,用户只需提供目标聊天 ID 和 OpenClaw 配置文件名称,即可一键完成从截图到发送的全流程自动化。 该技能的核心设计充分考虑了 OpenClaw 平台的安全限制与稳定性问题。由于 OpenClaw 的消息工具存在已知 bug(#15541),无法可靠发送媒体文件,因此本方案采用 curl 直接调用 Telegram Bot API 的方式绕过此缺陷,确保截图能够成功送达。同时,为避免路径访问权限问题,截图必须首先复制到 OpenClaw 工作区目录中,这是执行发送操作的前提条件。整个流程分为三步:使用系统命令捕获屏幕图像、将图像移至安全工作区、通过 API 发送照片消息。每一步都经过优化以确保兼容性和可靠性。 此外,该技能支持多配置档案管理,用户可在不同 OpenClaw profile(如 ‘main’ 或 ‘rescue’)下独立设置 Telegram 参数,实现灵活的环境切换。配置信息存储于 `~/.openclaw-/openclaw.json` 文件中,包含 bot token 和允许接收消息的 chat ID 列表。这种设计使得同一设备可用于多个项目或身份角色,而不会产生干扰。整体而言,这是一个高度实用且健壮的工具链组件,专为追求自动化与无缝集成的 macOS 用户设计。

核心功能特点

  1. 调用 macOS 原生 screencapture 命令实现高质量截图
  2. 自动将截图复制至 OpenClaw 安全工作区以符合权限要求
  3. 通过 Telegram Bot API 直接发送图片,规避平台消息工具的媒体发送缺陷
  4. 支持多 OpenClaw profile 配置,便于区分不同用途或环境
  5. 仅需用户提供目标聊天 ID 和 profile 名称即可完成全流程操作

适用场景

该工具特别适合需要频繁进行远程沟通的技术人员,例如运维工程师在排查服务器问题时,可以即时截取终端界面或错误日志画面,并立即发送给技术支持团队,显著缩短问题响应时间。对于自由开发者或远程工作者而言,当演示新功能或分享代码片段时,无需切换应用再手动上传图片,只需触发此技能即可将当前屏幕内容直接推送至协作群组或个人 Telegram 账户,保持工作流的连贯性。 另一个典型应用场景是自动化测试与监控。开发人员可以在 CI/CD 流程中集成该功能,一旦检测到异常状态或测试失败,系统自动截取相关输出画面并通过 Telegram 通知负责人,实现即时告警。此外,教育领域的在线讲师也常使用此技能,在上课过程中快速记录学生提问界面或操作步骤,方便课后回顾或分享给未能参与的学生。这些用例均体现了该工具在提升信息传递效率方面的核心价值。 值得一提的是,由于其基于标准 API 和系统命令构建,该技能具备良好的跨平台扩展潜力。虽然目前仅针对 macOS 设计,但其逻辑架构清晰,若未来 OpenClaw 支持其他操作系统,类似功能可轻松移植。同时,开放式的配置结构允许用户根据自身需求调整发送频率、添加水印或压缩图像等高级选项,进一步满足个性化使用习惯。总体来看,它不仅解决了特定技术痛点,也为后续功能迭代奠定了坚实基础。