iMessage Skill

简介

iMessage Skill 让 OpenClaw 能够通过 macOS 的 Messages 应用发送和接收 iMessage 消息。

安全增强版特性：

• ✅ 可信联系人名单
• ✅ 发送前确认机制
• ✅ 每日发送限制
• ✅ 安全事件日志
• ✅ 接收消息控制 OpenClaw（远程控制）

⚠️ 安全警告

重要提示：

• 本 Skill 可以发送短信/iMessage，请谨慎使用
• 首次使用需要配置可信联系人名单
• 向非可信联系人发送消息需要手动确认
• 远程控制功能默认关闭，需要手动启用并配置管理员
• 建议仅将常用联系人添加到可信名单
• 所有发送操作都会被记录到安全日志

系统要求

• 仅支持 macOS - 需要 macOS 10.14 或更高版本
• 需要 Messages 应用 - 系统自带的 Messages 应用必须可用
• 需要辅助功能权限 - 首次使用需要授予终端/脚本编辑器辅助功能权限
• iMessage 已登录 - 需要在 Messages 应用中登录 Apple ID

功能特性

消息发送

• 💬 发送文本消息 - 向指定手机号或邮箱发送 iMessage
• 🖼️ 发送图片 - 发送图片文件给联系人

消息接收

• 📨 查看最近消息 - 获取最近的聊天记录
• 👥 联系人列表 - 查看最近的联系人

远程控制（新功能）

• 📱 接收控制命令 - 通过 iMessage 控制 OpenClaw
• 🔐 管理员权限 - 只有管理员可以执行控制命令
• 🛡️ 命令白名单 - 只允许执行指定命令
• 🚫 命令黑名单 - 禁止执行危险命令

安全管理

• 🔒 可信名单 - 管理可信联系人，免确认发送
• ✅ 发送确认 - 向非可信联系人发送前需要确认
• 📊 发送限制 - 每日最多发送 100 条消息
• 📝 安全日志 - 记录所有发送操作到 security.log
• 📋 控制日志 - 记录所有控制命令到 control.log

安装

1. 安装 Skill

npx clawhub install imessage

2. 授予权限

首次使用时，系统会提示授予辅助功能权限：

1. 打开 系统设置 → 隐私与安全性 → 辅助功能
2. 添加并启用 终端（或你使用的脚本编辑器）
3. 确保 Messages 应用也在列表中

3. 确保 iMessage 已登录

打开 Messages 应用，确认已登录你的 Apple ID。

使用方法

可信联系人管理

# 添加可信联系人（免确认发送）
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py trust phone=+8613800138000

# 移除可信联系人
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py untrust phone=+8613800138000

# 查看所有可信联系人
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py list_trusted

管理员管理

# 添加管理员（可远程控制 OpenClaw）
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py admin phone=+8613800138000

# 移除管理员
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py unadmin phone=+8613800138000

远程控制管理

# 启用远程控制
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py enable_control

# 禁用远程控制
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py disable_control

发送文本消息

# 发送给可信联系人（无需确认）
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py send phone=+8613800138000 message="你好"

# 发送给非可信联系人（需要确认）
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py send phone=+8613900139000 message="测试消息"
# 系统会提示：是否继续发送? (yes/no):

发送图片

# 发送图片（同样需要安全检查）
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py send_image phone=+8613800138000 image=/Users/username/Pictures/photo.jpg

查看最近消息

# 查看所有最近消息
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py recent limit=10

# 查看特定联系人的消息
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py recent phone=+8613800138000 limit=5

# 检查并执行控制命令
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py recent check_control=true

查看联系人列表

# 获取最近联系人（显示可信和管理员状态）
python3 ~/.openclaw/workspace/skills/imessage/scripts/main.py contacts limit=20

远程控制功能

工作原理