名称： beepctl
描述： 通过 Beeper Desktop API 在各类即时通讯平台（Telegram、WhatsApp、Slack、iMessage 等）上发送消息、搜索聊天或管理会话。
主页： https://github.com/blqke/beepctl
元数据： {"clawdbot":{"emoji":"🐝","requires":{"bins":["beepctl"]},"install":[{"id":"npm","kind":"npm","package":"beepctl","global":true,"bins":["beepctl"],"label":"安装 beepctl (npm)"}]}}
Beeper Desktop API 的命令行工具 —— 在终端中统一管理所有即时通讯平台。通过单一界面控制您的 Telegram、WhatsApp、Slack、iMessage 等应用。
📖 设置与安装： 请参阅 GitHub 仓库
beepctl accounts # 列出已连接的账户
beepctl chats list # 列出最近聊天
beepctl chats list --search "John" # 搜索聊天
beepctl search "meeting" --after "1d ago" # 搜索消息
beepctl send <chat-id> "Hello!" # 发送消息
beepctl auth show # 查看认证状态和令牌
beepctl auth set <token> # 设置 API 令牌
beepctl auth clear # 清除已保存的令牌
beepctl accounts # 列出所有已连接的账户
beepctl chats list # 列出收件箱（非归档）
beepctl chats list --limit 20 # 限制结果数量
beepctl chats list --search "John" # 按名称过滤
beepctl chats list --inbox archive # 仅显示归档聊天
beepctl chats list --inbox low-priority # 仅显示低优先级聊天
beepctl chats list --inbox all # 所有聊天
beepctl chats list --type group # 按类型过滤（single/group/any）
beepctl chats list --unread-only # 仅显示未读聊天
beepctl chats list --activity-after "1d ago" # 按最近活动时间过滤
beepctl chats show <chat-id> # 查看聊天详情（含参与者）
beepctl chats create <account> <users...> # 创建新聊天
收件箱过滤器： primary（默认）、archive、low-priority、all
beepctl messages <chat-id> # 获取聊天中的最近消息
beepctl messages <chat-id> --limit 10 # 限制结果数量
beepctl messages work --after "1d ago" # 使用别名 + 时间过滤
beepctl messages <chat-id> --before "1h ago" # 获取指定时间前的消息
beepctl search "query" # 在所有聊天中搜索
beepctl search "query" --limit 10 # 限制结果数量
beepctl search "meeting" --after "1d ago" # 按时间过滤
beepctl search "hello" --chat work # 按聊天/别名过滤
beepctl search "files" --media file # 按媒体类型过滤
beepctl search "dm" --chat-type single # 按聊天类型过滤
beepctl search "update" --sender others # 按发送者过滤（me/others）
beepctl search "msg" --account <id> # 按账户过滤
beepctl search "todo" --include-low-priority # 包含低优先级聊天
beepctl search "important" --exclude-muted # 排除已静音的聊天
组合过滤器示例：
beepctl search "deploy" --chat work --sender others --after "1d ago" --media link
beepctl search "hello" --chat work family # 多个聊天（空格分隔）
beepctl search "test" --chat id1,id2,id3 # 多个聊天（逗号分隔）
时间格式： 1h ago、2d ago、3w ago、1mo ago、yesterday、today
媒体类型： any、video、image、link、file
为常用聊天 ID 创建快捷方式：
beepctl alias list # 列出所有别名
beepctl alias add work <chat-id> # 创建别名
beepctl alias show work # 显示别名对应的值
beepctl alias remove work # 删除别名
beepctl send work "使用别名发送！" # 在任何命令中使用别名
beepctl archive <chat-id> # 归档聊天
beepctl archive <chat-id> --unarchive # 取消归档
beepctl archive work # 使用别名
beepctl archive <chat-id> --quiet # 不显示确认信息
⚠️ 未经用户明确确认，切勿直接发送消息！
务必先显示消息内容和收件人，然后请求确认。
beepctl send <chat-id> "你好！" # 发送消息
beepctl send myself "快速笔记" # 发送给自己
beepctl send <chat-id> "回复" --reply-to <msg-id> # 回复消息
beepctl send <chat-id> "消息" --quiet # 不显示确认输出
beepctl focus # 将 Beeper 窗口置顶
beepctl focus <chat-id> # 打开指定聊天
beepctl focus <chat-id> -m <msg-id> # 跳转到指定消息
beepctl focus <chat-id> -d "草稿" # 预填充草稿文本
beepctl focus <chat-id> -a /path/file # 预填充草稿附件
beepctl send 仅支持文本。要发送媒体文件，请使用带草稿的聚焦功能：
beepctl focus <chat-id> -a /path/to/image.png -d "图片说明"
# 然后在 Beeper 中按 Enter 发送
beepctl contacts search <account> <query> # 在指定账户中搜索联系人
beepctl download <mxc-url> # 下载附件（mxc:// 格式的 URL）
beepctl download <mxc-url> -o /path # 保存到指定路径
beepctl reminders set <chat> 30m # 30 分钟后提醒
beepctl reminders set <chat> 1h # 1 小时后提醒
beepctl reminders set <chat> 2d # 2 天后提醒
beepctl reminders set <chat> tomorrow # 明天提醒
beepctl reminders clear <chat> # 清除提醒
!gZ42vWzDxl8V0sZXWBgO:beeper.localmyself 用于向自己的聊天发送消息