SuperAPI AI 工具集

imsg

编程与开发

查看项目

更新于 10-16 03:06

技能介绍

imsg 是供 OpenClaw 智能体调用的 CLI,用于 iMessage/SMS 的私聊、群聊、回复、表情回应、投票、监听及私有 API 操作。当通用 message 工具无法覆盖本地 Messages.app 历史、目标发现、监听或管理类能力时使用;不适用于 Telegram、Signal、WhatsApp、Discord、Slack。

主要能力:读取/列出/搜索/监听(chats、group、history、search、watch)、基础文本与文件发送(send)、对最近一条来信做标准 tapback(react);私有 API 桥接支持富回复、文本格式、特效、主题、多部分发送、原生投票与投票、按消息 GUID 的 tapback 及移除、编辑/撤回/删除、已读回执、输入指示、群组创建与成员/名称/照片管理、账户与 whois 等。

使用方式:先解析会话,选择私聊、已有群或新建群;优先用 message 动作,否则选能力最低的 imsg 命令。读取用 --json(换行分隔 JSON,可用 jq -s)。示例:imsg chats --limit 25 --json | jq -s;imsg send --chat-id 42 --text "On my way";imsg send-rich --chat 'iMessage;-;+15551234567' --reply-to <message-guid> --text "reply text";imsg poll send --chat 'iMessage;+;chat0000' --question "Dinner?" --option "Pizza" --option "Sushi";imsg watch --chat-id 42 --since-rowid 9000 --json;imsg status --json 检查桥接可用性。

限制与要求:需 macOS 14+ 且 Messages.app 已登录;私有 API 模式需注入桥接,imsg launch 会重启 Messages.app,属可见状态变更,需先确认。读取需完全磁盘访问权限,公共发送需自动化权限,公共 react 需辅助功能权限,联系人解析需可选联系人权限;SMS 发送需 iPhone 短信转发。Linux 仅能读取复制的 chat.db,不能发送、回应、启动 Messages、标记已读或输入。发送、已读、编辑、撤回、投票、群组变更等可见操作前须确认收件人、会话与内容;不得向未知号码或歧义联系人发送。jq 仅为示例格式化工具,非硬性依赖。