Beeper API CLI 是一款专为开发者设计的命令行工具，它通过封装 Beeper Desktop 的本地 API，实现了跨多个即时通讯平台的统一消息管理。该工具支持 WhatsApp、Telegram、Signal、Instagram、Twitter/X、LinkedIn 和 Facebook Messenger 等主流聊天网络，让用户能够以编程方式读取和发送消息。其核心优势在于提供了 LLM（大型语言模型）友好的 JSON 输出格式，同时兼顾人类可读的文本和 Markdown 格式，极大提升了自动化脚本与 AI 工作流的集成效率。 使用 Beeper API CLI 前，用户需在 Beeper Desktop 中开启 API 访问权限并获取 Bearer Token。随后通过设置环境变量 `BEEPER_TOKEN` 来授权 CLI 操作，默认连接地址为 `http://[::1]:23373`（即本机 IPv6 回环地址）。若从远程机器调用，则需先在 Beeper Desktop 的 API 设置中添加允许的 IP 地址，并相应调整 `BEEPER_API_URL`。CLI 提供了丰富的命令接口，包括列出所有聊天、获取特定会话详情、检索历史消息、搜索关键词内容以及发送新消息等功能。特别强调的是，所有发送操作必须经过用户明确口头批准后方可执行，这是出于安全策略的重要限制。 该工具不仅适用于本地开发调试，也支持跨平台部署（macOS、Linux、Windows），且具备良好的错误提示机制。无论是构建个人自动化助手、集成到智能客服系统，还是用于团队协作的通知机器人，Beeper API CLI 都能提供稳定可靠的消息交互能力。此外，它还特别优化了与 Clawdbot 等 AI 工具的联动使用场景，简化了配置流程，使开发者能快速上手并开始构建复杂的应用逻辑。
核心功能特点
- 支持多平台消息读写：覆盖 WhatsApp、Telegram、Signal、Instagram、Twitter/X、LinkedIn 及 Facebook Messenger 等主流聊天应用
- LLM 友好设计：默认输出结构化 JSON 数据，便于程序解析和 AI 处理；同时提供纯文本与 Markdown 格式供人工阅读
- 安全可靠的消息发送机制：强制要求用户在命令行中显式确认后才会发送消息，避免误发风险
- 灵活的输出格式控制：可通过 `–output` 参数切换 JSON、text 或 markdown 三种展示样式
- 自动发现 API 服务：内置 `discover` 命令可检测本地 Beeper Desktop 的 API 地址，降低配置门槛
- 完善的远程访问支持：允许从不同主机调用，只需在 Beeper Desktop 设置中授权目标 IP 即可实现跨设备通信
适用场景
Beeper API CLI 特别适合需要统一管理多个社交账号消息流的自动化项目。例如，企业运维团队可以利用它创建一个监控告警机器人，当服务器出现异常时，自动将日志摘要推送到指定的 Telegram 群组或 WhatsApp 工作群中，确保关键信息及时触达相关人员。另一个典型用例是个人知识管理系统，用户可将每日读书笔记或研究进展通过 Signal 发送给固定联系人，再由 CLI 定期汇总生成周报，形成闭环的信息流转链条。 对于依赖外部服务的 AI 应用而言，此工具尤为实用。比如开发一款智能日程助理，它可以先调用 `chats list` 查找包含‘会议提醒’字样的对话，再结合 `messages list` 获取最近上下文，最后根据自然语言指令自动生成并发送提醒内容——整个过程无需人工干预，完全由脚本驱动完成。这种模式非常适合集成进智能家居控制中心、个人数字助理或客户服务聊天机器人等场景中。 此外，开源社区中的开发者也能借助 Beeper API CLI 构建跨平台协作插件。假设某项目成员分布在不同的通讯平台上，他们可以通过统一的命令行接口同步更新任务状态、共享文件链接或协调开发进度，从而打破平台壁垒，提升团队协同效率。无论是小型脚本还是大型系统集成，只要涉及多平台消息交互，Beeper API CLI 都能成为强有力的技术支撑。