$ ~/registry/skill/openclaw-imsg

SKILL

imsg

通过命令行列出聊天、查看短信历史并发送 iMessage 或短信。

星标

★ 377,470

来源

GitHub

更新于

2026-06-16

// 安全评估需留意

仅提示词，不执行代码
开源可审计
社区验证· 377.5k

总评

整体风险偏低到中等：无独立密钥、无自定义远程端点，且来源为可审计开源项目并有很高社区采用度。主要注意点在于其声明需要 macOS 的 Full Disk Access 与 Messages.app 自动化权限，可读取聊天记录并代表用户发送 iMessage/SMS。

凭证密钥低风险

材料明确标注无需额外 API key、token 或环境变量；主要依赖用户已登录的 macOS Messages.app 会话，而非技能自身持有独立凭证，因此独立凭证泄露面较小。

网络外发需留意

未声明连接第三方自定义远程端点，但其核心功能是通过 Messages.app 发送 iMessage/SMS，因此用户输入的消息内容和可能的附件会被传递给消息接收方，并经由 Apple/运营商消息基础设施传输。

代码执行需留意

文档展示以 CLI 形式执行本机命令（如 imsg chats/history/send/watch），并声明发送消息需要对 Messages.app 的 Automation 权限；这属于本地进程执行与系统自动化能力，但未见超出声明功能的异常系统权限请求。

数据访问需留意

材料明确要求终端具备 Full Disk Access，并支持列出聊天、读取历史、查看附件信息，说明其可访问本机 Messages 相关数据，涉及较敏感的个人通信内容；不过该访问范围与其声明用途基本一致。

来源供应链需留意

正面因素是 GitHub 开源、源码可审计且社区采用度极高；未见闭源外传红旗。需留意的是许可证未声明、维护状态未知，且当前材料主要是 README/技能描述，实际实现与依赖仍应在仓库中进一步核验。

安全建议

仅在可信 macOS 设备上启用，并把 Full Disk Access 与 Automation 权限限制给必要终端/宿主进程。
发送前要求人工确认收件人、消息内容和附件路径，避免误发敏感信息。
审查开源仓库中的实际实现、发布物与依赖清单，确认其确实只访问 Messages 所需范围。
如不再使用，及时撤销终端对 Full Disk Access 和 Messages.app 自动化控制权限。

审计模型: gpt-5.4 · 2026-06-16

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "imsg" 技能：
1. 下载 https://raw.githubusercontent.com/openclaw/openclaw/main/skills/imsg/SKILL.md
2. 保存为 ~/.claude/skills/imsg/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

查看最近聊天记录

输入

请用 imsg 列出最近 10 个聊天会话，并显示与“张三”的最近 20 条消息记录。

预期产出

返回最近聊天列表，并展示指定联系人的消息历史内容。

发送会议提醒短信

输入

请用 imsg 向联系人“李四”发送短信：明天下午 3 点开会，记得带上项目资料。

预期产出

生成并执行发送指令，成功把提醒消息发给指定联系人。

按联系人检索历史

输入

请用 imsg 查询与“王敏”过去 7 天的消息记录，并按时间顺序整理出来。

预期产出

输出指定时间范围内的聊天记录，便于回顾沟通内容。

// 文档

imsg

Use imsg to read and send iMessage/SMS via macOS Messages.app.

When to Use

Use when:

User explicitly asks to send iMessage or SMS
Reading iMessage conversation history
Checking recent Messages.app chats
Sending to phone numbers or Apple IDs

When NOT to Use

Do not use when:

Telegram messages -> use message tool with channel:telegram
Signal messages -> use Signal channel if configured
WhatsApp messages -> use WhatsApp channel if configured
Discord messages -> use message tool with channel:discord
Slack messages -> use slack skill
Group chat management (adding/removing members) -> not supported
Bulk/mass messaging -> always confirm with user first
Replying in current conversation -> just reply normally (OpenClaw routes automatically)

Requirements

macOS with Messages.app signed in
Full Disk Access for terminal
Automation permission for Messages.app (for sending)

Common Commands

List Chats

imsg chats --limit 10 --json

View History

# By chat ID
imsg history --chat-id 1 --limit 20 --json

# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json

Watch for New Messages

imsg watch --chat-id 1 --attachments

Send Messages

# Text only
imsg send --to "+14155551212" --text "Hello!"

# With attachment
imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg

# Specify service
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms

Service Options

--service imessage - Force iMessage (requires recipient has iMessage)
--service sms - Force SMS (green bubble)
--service auto - Let Messages.app decide (default)

Safety Rules

Always confirm recipient and message content before sending
Never send to unknown numbers without explicit user approval
Be careful with attachments - confirm file path exists
Rate limit yourself - don't spam

Example Workflow

User: "Text mom that I'll be late"

# 1. Find mom's chat
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mom"))'

# 2. Confirm with user
# "Found Mom at +1555123456. Send 'I'll be late' via iMessage?"

# 3. Send after confirmation
imsg send --to "+1555123456" --text "I'll be late"