SuperAPI AI 工具集

imsg

编程与开发

查看项目

更新于 10-16 03:06

技能介绍

用途:imsg 是 macOS 上的命令行工具,供 OpenClaw 智能体操作 iMessage 与 SMS,覆盖私聊、已有或新建群聊、线程回复、表情回应、投票、历史读取与消息监听。若通用 message 工具已能覆盖当前 iMessage 操作,应优先使用它;需要本地 Messages.app 历史、目标发现、监听或管理类/私有 API 能力时再用 imsg。不适用于 Telegram、Signal、WhatsApp、Discord、Slack 等平台。

主要能力:读取与检索包括 chats、group、history、search、watch;基础发送包括 send(文本与文件);react 可对聊天中最近一条收到的消息做标准表情回应。私有 API 桥接解锁富回复、文本格式、效果、主题、分片发送、原生投票与投票投票、按消息 GUID 点按回应及移除、编辑/撤回/删除、已读回执、输入状态、群创建/改名/改头像/增删成员/退出/删除/标记,以及账户、whois、昵称查询。

使用方式:先用 --json 读取并以 --chat-id 或 chat GUID 等稳定标识定位目标;发送前确认收件人、聊天与内容。示例:imsg chats --limit 25 --json | jq -s、imsg history --chat-id 42 --limit 20 --attachments --json、imsg send --chat-id 42 --text "On my way"、imsg react --chat-id 42 --reaction like、imsg watch --chat-id 42 --reactions --json。投票需桥接且至少两个 --option;投票用 --option-id、--option-index 或 --option 之一。多聊/守护进程可用 imsg rpc(stdin/stdout 上的 JSON-RPC 2.0),先看 imsg status --json 的 rpc_methods。

环境与限制:需要 macOS 14+ 且 Messages.app 已登录;发送/回应/桥接还依赖私有 API 模式、完全磁盘访问、自动化与辅助功能权限,SMS 发送需 iPhone 短信转发。Linux 仅能读取拷贝的 chat.db,不能发送、回应或启动 Messages.app。宿主不支持某些私有 API 能力时应说明并给出最接近的非桥接方案,不要静默降级。