OpenClaw 接入 iMessage：imsg 工具安装、权限配置与远程 Mac 部署

OpenClaw 支持 iMessage 作为消息频道，让你可以通过 iPhone 的默认消息应用与 AI 助手对话。注意：新部署推荐使用 BlueBubbles，imsg 集成为遗留方案。

前置条件#

• macOS 设备（iMessage 仅在 Apple 设备上可用）
• 已登录 iMessage 的 Apple ID
• Homebrew（用于安装 imsg）

快速配置（4 步）#

第 1 步：安装 imsg#

brew install steipete/tap/imsg
imsg rpc --help  # 验证安装

第 2 步：配置 OpenClaw#

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "/usr/local/bin/imsg",
      "dbPath": "/Users/<你的用户名>/Library/Messages/chat.db"
    }
  }
}

第 3 步：启动 Gateway#

openclaw gateway

第 4 步：批准首次 DM 配对#

openclaw pairing list imessage
openclaw pairing approve imessage CODE

配对请求 1 小时内有效。

macOS 权限配置#

imsg 需要以下 macOS 权限：

完整磁盘访问权限（必须）： 系统设置 → 隐私与安全性 → 完整磁盘访问权限 → 添加 Terminal（或 imsg 所在应用）

自动化权限（如需发送消息）： 首次使用时系统会自动弹出权限请求，允许即可。

辅助功能（部分功能需要）： 系统设置 → 隐私与安全性 → 辅助功能 → 添加相关应用

访问控制#

DM 访问策略#

{
  "channels": {
    "imessage": {
      "dmPolicy": "pairing",
      "allowFrom": ["+8613800138000"]
    }
  }
}

dmPolicy 选项：

• pairing（默认）：未知发件人收到配对码
• allowlist：只允许 allowFrom 列表中的号码
• open：允许所有人
• disabled：禁用私信

allowFrom 接受手机号码（E.164 格式）或 Apple ID 邮箱。

群组访问#

{
  "channels": {
    "imessage": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["+8613800138000"]
    }
  }
}

远程 Mac 部署#

iMessage 只能在 Mac 本地运行，但 OpenClaw Gateway 可以部署在任意服务器上，通过 SSH 远程调用 imsg：

# 创建 SSH 包装脚本
cat > ~/.openclaw/scripts/imsg-ssh << 'EOF'
#!/usr/bin/env bash
exec ssh -T your-mac-hostname imsg "$@"
EOF
chmod +x ~/.openclaw/scripts/imsg-ssh

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "~/.openclaw/scripts/imsg-ssh",
      "remoteHost": "user@your-mac-hostname",
      "includeAttachments": true,
      "attachmentRoots": ["/Users/*/Library/Messages/Attachments"],
      "remoteAttachmentRoots": ["/Users/*/Library/Messages/Attachments"]
    }
  }
}

注意：remoteHost 格式为 host 或 user@host（不含 SSH 选项）。远程主机密钥必须已在 ~/.ssh/known_hosts 中。

媒体和附件#

{
  "channels": {
    "imessage": {
      "includeAttachments": true,
      "maxAttachmentBytes": 10485760
    }
  }
}

支持的媒体类型：图片、音频（自动转录）、文件。

为什么推荐 BlueBubbles？#

对于新的 iMessage 部署，OpenClaw 官方推荐使用 BlueBubbles 而不是 imsg：

• BlueBubbles 是开源项目，活跃维护
• 支持更多功能（已读回执、打字指示、Tapback 反应）
• 更稳定的远程部署支持
• imsg 为遗留集成，未来可能移除

如果你已经在用 imsg，当前版本继续可用；新部署建议直接使用 BlueBubbles。

常见问题#

imsg 无法访问 Messages 数据库？ 确认已授予「完整磁盘访问权限」。在 macOS 14+ 上，权限更加严格，需要明确授权。

远程部署附件不显示？ 检查 remoteHost 配置正确，且远程主机密钥在 known_hosts 中。

配对后仍无法收到消息？ 运行 openclaw logs --follow 查看实时日志，检查 imsg 进程是否正常启动。

原文：iMessage - OpenClaw | 来源：OpenClaw 官方文档