一、技能概述
Imsg 是 macOS 平台终端命令行 iMessage/SMS 收发工具，直接读写苹果 Messages.app 本地数据库，纯终端、无 GUI、轻量、自动化友好imsg.sh。
- 支持：iMessage（蓝）、SMS 短信（绿）、MMS 彩信、群聊、附件
- 运行：macOS 专属，依赖系统 Messages.app
- 模式：本地数据库读取 + AppleScript 发送，无私有 API、安全稳定
- 用途：终端发信、脚本自动化、服务器告警、短信网关、OpenClaw 消息中枢
二、核心能力（终端全操作）
✅ 消息接收（只读）
- imsg chats：列出所有会话（ID、联系人、时间）
- imsg history：查看历史消息（分页、时间、附件）
- imsg watch：实时监听新消息（事件推送，JSON 流）imsg.sh
- 联系人解析：自动匹配通讯录姓名、电话、Apple IDimsg.sh
- 导出格式：纯文本 / JSON（机器可读）imsg.sh
✅ 消息发送（iMessage/SMS）
- 文本短信：手机号（+86）/Apple ID / 联系人姓名
- 附件发送：图片、文件、视频、语音（MMS）imsg.sh
- 自动路由：iPhone→iMessage（免费）、安卓→SMS（运营商）
- 群聊支持：群发、群消息监听imsg.sh
- E.164 号码标准化：自动格式化手机号
✅ 高级特性
- 本地数据库直读：
~/Library/Messages/chat.db，无网络中转imsg.sh - 端到端加密兼容：iMessage 原生加密
- 轻量无后台：单次执行，不驻留进程imsg.sh
- 脚本友好：JSON 输出、可管道、可嵌入 Shell/Python/Nodeimsg.sh
三、安装（macOS）
1. Homebrew（推荐）
bash
运行
brew install steipete/tap/imsg
2. Go Install
bash
运行
go install github.com/steipete/imsg/cmd/imsg@latest
3. 权限（必须）
- 系统设置 → 隐私与安全性 → 完全磁盘访问：给终端 /iterm2 授权
- 自动化权限：允许终端控制 Messages.app
- iPhone 短信转发：Mac 接收 SMS（设置→信息→短信转发）
四、常用命令（直接复制）
1. 查看会话
bash
运行
imsg chats --limit 10 --json
2. 查看历史消息
bash
运行
imsg history --chat-id 123 --limit 50 --attachments
3. 实时监听新消息
bash
运行
imsg watch --chat-id 123 --json
4. 发送短信（手机号）
bash
运行
imsg send --to "+8613800138000" --text "Hello from Terminal!"
5. 发送 iMessage（Apple ID）
bash
运行
imsg send --to "user@icloud.com" --text "终端iMessage"
6. 发送图片 / 文件
bash
运行
imsg send --to "+8613800138000" --text "照片" --file ~/Desktop/photo.jpg
五、OpenClaw 集成指令
imsg 发送 +手机号 +内容imsg 监听→ 实时推送消息到 OpenClawimsg 历史 +数量→ 读取最近短信imsg 发送文件 +手机号 +路径
六、优势
✅ 纯终端无 GUI，服务器 / SSH 可用
✅ iMessage 免费 + SMS 兼容，双模自动切换
✅ 本地直读数据库，速度快、隐私安全imsg.sh
✅ 轻量无后台，稳定可靠imsg.sh
✅ 脚本 / 自动化友好，JSON 输出易集成imsg.sh
✅ OpenClaw 原生技能，消息中枢、告警、通知首选
七、限制
- 仅 macOS，Windows/Linux 不可用
- 必须登录 Messages.app
- 接收只读，不修改数据库
- 依赖苹果系统服务