beepctl
通过命令行控制 Beeper，为 AI 智能体提供跨平台消息能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：beepctl。 它的用途是：通过命令行控制 Beeper，为 AI 智能体提供跨平台消息能力 完整的 Skill 内容见：https://321skill.com/skills/beepctl/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查Beeper里‘项目组’聊天最近有没有提到服务器宕机。”，它会通过 beepctl 搜索该聊天记录中的关键词并返回结果。或者
对AI说：“把‘家庭群’今天发的所有图片附件下载到本地。”，它会组合使用 beepctl 的消息查询和下载命令来完成。
介绍
beepctl 是一个非官方的命令行工具，用于与 Beeper Desktop API 进行交互。Beeper 是一个统一消息平台，聚合了多个主流通讯应用。该工具解决了开发者和 AI 智能体需要通过编程方式访问和管理跨平台即时消息的需求。
用户首先需要在 Beeper Desktop 中启用开发者选项并生成 API 令牌，然后通过 beepctl 进行配置。配置完成后，即可使用一系列命令来管理账户、浏览聊天、查看和发送消息、搜索历史记录，甚至下载聊天中的附件。
它非常适合那些希望将消息功能集成到自动化脚本、工作流或 AI 智能体中的开发者、运维工程师和智能体开发者。例如，可以编写脚本监控特定群组的消息，或让 AI 助手自动读取并总结未读消息。
需要注意的是，Beeper Desktop API 仍处于测试阶段，可能存在不兼容的变更。此外，该工具是第三方项目，并非由 Beeper 官方支持或赞助。使用前请确保已安装并运行指定版本的 Beeper Desktop 客户端。
核心特点
与通用的消息机器人框架不同，beepctl 直接对接 Beeper 这个“消息聚合器”，通过一个统一的 API 和 Token，即可让 AI 智能体或脚本同时与微信、Telegram、Discord 等数十个平台交互，无需为每个平台单独开发适配和申请权限。
注意事项
不适合需要直接、独立对接单一特定消息平台（如仅微信）官方 API 的场景，且其功能深度受限于 Beeper Desktop 客户端本身的支持范围。
常见问题
beepctl 是 Beeper 官方工具吗？
不是，这是一个由社区开发的非官方项目，与 Beeper 公司无关。
使用 beepctl 需要付费吗？
beepctl 本身免费开源，但需要配合 Beeper 客户端使用，Beeper 服务可能有其自身的订阅政策。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/beepctl/raw/index.md 读取 beepctl 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/beepctl/raw/index.md（查看排版版本）