OpenClaw(Clawdbot)快速接入iMessage的操作指南

2026-03-11 15:30:02 脚本之家

本教程将详细指导你完成 OpenClaw与 iMessage 的接入配置，获得最丝滑的 OpenClaw 体验，新手可直接跟随操作。

前置准备

确保你的 macOS 操作系统中已安装以下工具，若未安装请先执行对应安装命令：

brew（包管理器）：若未安装，执行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
npm（Node.js 包管理器）：若未安装，可通过 brew 安装 brew install node，安装后自动附带 npm

安装并验证 imsg（iMessage 命令行工具）

imsg 是 OpenClaw 对接 iMessage 的核心依赖，用于读取 iMessage 聊天数据，需先安装并完成自检。

# 安装 imsg（通过指定 tap 源安装）
brew install steipete/tap/imsg
# 关键自检（验证能否读取 iMessage 聊天列表，核心步骤）
imsg chats --limit 3
# 若输出 3 条聊天记录，说明 chat.db（iMessage 数据库）权限正常；
# 若提示权限错误，需前往「系统设置-隐私与安全性」授予终端访问「文稿与桌面文件夹」「信息」的权限。

如果出现权限错误，请打开「系统设置-隐私与安全-左下角➕-添加“短信”与“终端”」

安装 OpenClaw

参考OpenClaw官方文档的指引（点击前往），在macOS系统中安装OpenClaw。

打开OpenClaw命令行配置工具

打开macOS终端（Terminal），输入 openclaw onboard 命令，开始配置OpenClaw。

openclaw onboard

配置OpenClaw

同意免责声明

运行上面的命令后，将会出现一个问题：是否知晓风险，选择Yes就行。

配置模式选择：快速入门

接下来需要选择Onboarding的模式，我们选择QuickStart。

模型配置

注意由于Kimi、MiniMax、GLM分了国际版和国内版，OpenClaw 默认集成的是国际版的接口地址，因此如果在配置模型时需要使用这三家的模型，则需要登录国际版控制台申请API Key：

- Kimi：https://platform.moonshot.ai/

- MiniMax：https://platform.minimax.io/

- GLM：https://z.ai/manage-apikey/apikey-list

紧接着的一步是选择Model/auth提供商，如果想省时省心的话优先推荐选择国内的厂商（MiniMax、Qwen、Moonshot AI、Z.AI/GLM）默认模型选择Keep current。

聊天软件（Channel）配置

选中iMessage，按回车键确认；

技能包（Skill）配置

新手暂时无需添加额外技能包，选中 “No” 跳过，按回车键确认；

Hooks 配置

选中 “Memory”（启用记忆功能，支持多轮对话上下文关联，避免每次聊天都需要重复说明需求），按回车键确认；

等待部署完成

配置确认后，系统将自动完成部署，耗时约 30 秒 - 1 分钟，无需操作，待配置向导自动退出，返回命令行界面（显示「root@VM-xxx-ubuntu:~#」），即为部署成功。

配置并启用 iMessage 通道（核心步骤）

需在 OpenClaw 配置中添加 iMessage 相关配置，确保 OpenClaw 能通过 imsg 访问 iMessage 数据。首先获取必要的路径信息，再通过可视化或手动方式配置。

获取关键路径

先执行以下命令，获取 imsg 安装路径和 iMessage 数据库（chat.db）路径，后续配置需用到这两个路径。

# 1. 获取 imsg 路径（拷贝命令输出结果，后续填写到 cliPath 中）
which imsg
# 2. 获取 chat.db 路径（iMessage 聊天数据库，通常默认路径如下）
echo "$HOME/Library/Messages/chat.db"
# 验证数据库文件是否存在
ls -l "$HOME/Library/Messages/chat.db"
# 若提示文件不存在，确认你的 iMessage 已正常使用（需先在 macOS 上登录 Apple ID 并使用过 iMessage）

配置 iMessage 通道

配置需确保包含以下4个核心参数，缺一不可：

channels.imessage.enabled = true（启用 iMessage 通道）
channels.imessage.cliPath = "<imsg 路径>"（步骤 4.1 中获取的 imsg 路径）
channels.imessage.dbPath = "<chat.db 路径>"（步骤 4.1 中获取的 chat.db 路径）
channels.imessage.dmPolicy = "pairing"（推荐默认配置，用于控制私信权限）

Dashboard 可视化配置

先启动 OpenClaw 网关（后续步骤 5 详细说明，此处可提前启动）：openclaw gateway --port 18789 --verbose
启动 Dashboard（可视化配置界面），打开新的终端窗口执行： openclaw dashboard
打开浏览器，访问 Dashboard 地址：http://127.0.0.1:18789/
- 在 Dashboard 左侧导航栏进入「Config」页面，找到「channels.imessage」相关配置项：
- 勾选「enabled」，设置为 true；
- 填写「cliPath」，粘贴步骤 4.1 获取的 imsg 路径；
- 填写「dbPath」，粘贴步骤 4.1 获取的 chat.db 路径；
- 设置「dmPolicy」为「pairing」；
配置完成后，点击页面底部「Save」保存配置，配置将自动同步到 ~/.clawdbot/clawdbot.json 文件。

前台启动 OpenClaw 网关

网关是 OpenClaw 与 iMessage 通信的核心，启动网关后，即可完成 OpenClaw 与 iMessage 的接入，示例使用 18789 端口（可根据需求修改端口号）。

# 前台启动网关
clawdbot gateway --port 18789 --verbose

配对（完成最终接入，实现手机控制Mac）

完成网关启动和配置后，需通过配对操作绑定手机与电脑的iMessage，方可实现手机控制Mac，步骤如下：

发送配对触发消息：用你的手机，给当前电脑登录的 iMessage 账号（与电脑Apple ID一致）发送任意一条消息，发送后电脑终端会自动返回一个配对码（请记住或复制该配对码）。

停止当前网关服务：回到启动网关的终端窗口，按下 ctrl + c 组合键，停止正在运行的网关服务。

执行配对批准命令：在终端中输入以下命令，将 <配对码> 替换为步骤1中获取的实际配对码，输入完成后按下回车执行： openclaw pairing approve imessage <配对码>

重新启动网关：配对批准完成后，再次启动网关，确保配对生效，执行命令如下：openclaw gateway --port 18789 --verbose

网关重新启动成功后，配对完成，此时你即可通过手机 iMessage 发送指令，实现对Mac的控制。

效果如图

以上就是OpenClaw(Clawdbot)快速接入iMessage的操作指南的详细内容，更多关于OpenClaw接入iMessage的资料请关注脚本之家其它相关文章！