OpenClaw Mac 安装与手机 App 连接教程:把你的手机变成 AI 助手节点

OpenClaw 可以理解成一个“本地 AI 助手网关”。它不是单纯的聊天机器人，而是把模型、工具、设备和聊天入口串起来：你可以在电脑上运行 Gateway，再用 Telegram、WhatsApp、Slack、Discord、Signal、iMessage，或者手机 OpenClaw App 接入它。官方首页对它的定位是：在你常用的聊天软件里，让 AI 帮你处理邮件、日程、任务等操作。

这篇教程以 **Mac 安装 OpenClaw + 手机 OpenClaw App 连接 Gateway 为主。

一、准备工作

你需要准备：

1. 一台 Mac
2. 一个可用网络
3. 终端 Terminal
4. 手机 OpenClaw App手机 OpenClaw 应用程序
5. 一个可用模型，例如 Grok / xAI、OpenAI、Anthropic 等
6. 如果要接 Grok，建议准备 SuperGrok 或 X Premium 订阅（ SuperGrok 官方订阅升级服务：cnmGrok.com ）

OpenClaw 官方文档建议使用 Node 24，最低要求是 Node 22.19+；

不过官方安装脚本会自动处理 Node 检测和安装。

二、Mac 安装 OpenClaw

方式一：一键安装，推荐新手使用

打开 Mac 的 终端 Terminal，复制执行：curl -fsSL https://openclaw.ai/install.sh | bash

这个官方安装脚本会自动检测系统、安装所需 Node、安装 OpenClaw，并启动 onboarding 初始化流程。

安装完成后，检查版本：openclaw --version

如果能看到版本号，说明安装成功。

然后进入初始化配置：openclaw onboard

如果你希望顺便安装后台 daemon，可以执行：openclaw onboard --install-daemon

方式二：npm 手动安装

如果你本机已经有 Node，也可以直接用 npm 安装：npm install -g openclaw@latest openclaw onboard --install-daemon

官方文档也提供 npm、pnpm、bun 等安装方式；如果你已经自己管理 Node，npm 方式会更直接。

三、连接模型：以 Grok / xAI 为例

如果你想让 OpenClaw 使用 Grok，可以走 xAI OAuth 授权。

新装 OpenClaw 时直接运行：openclaw onboard --install-daemon

到模型授权步骤时，选择 xAI / Grok OAuth。

如果你已经安装好了 OpenClaw，只是想单独登录 Grok，不需要重新跑完整 onboarding，直接执行： openclaw models auth login --provider xai --method oauth

登录完成后，可以把 Grok 设置成默认模型：openclaw models set xai/grok-4.3

官方文档说明，OpenClaw 内置 xAI provider，推荐普通用户通过 Grok OAuth 使用；这种方式不需要 xAI API Key，也不需要 Grok Build App。

四、启动 OpenClaw Gateway

手机 App 不是单独运行完整 OpenClaw 的主机，它更像一个 companion node / 设备节点。真正的 Gateway 需要跑在 Mac、Linux 或 Windows WSL2 上。iOS 文档明确说明，iPhone App 会通过 WebSocket 连接到 Gateway；Android 文档也说明 Android App 是 companion node，需要一个正在运行的 Gateway。

在 Mac 终端执行：openclaw gateway --port 18789

如果想看更详细日志：openclaw gateway --port 18789 --verbose

正常情况下，日志里应该能看到类似：listening on ws://0.0.0.0:18789

这说明 Mac 上的 Gateway 已经启动。

五、让手机和 Mac 在同一个网络

最简单的连接方式是： Mac 和手机连接同一个 Wi-Fi

然后在 Mac 上查看本机局域网 IP：ipconfig getifaddr en0

通常会得到类似：192.168.1.23

那么你的 Gateway 地址就是：ws://192.168.1.23:18789

如果你的 Mac 是有线网络，可能需要查：ipconfig getifaddr en1

六、手机 OpenClaw App 连接 Gateway

iPhone 连接方式

iOS 版 OpenClaw App 的官方说明是：它会连接到 Gateway，并暴露 Canvas、屏幕快照、相机、定位、Talk mode、Voice wake 等能力；iPhone App 版本会在对应 release 启用时通过 Apple 渠道分发，本地开发者也可以从源码构建。

1. 打开 Mac 终端，先确认 OpenClaw 能用：openclaw --version

2. 如果还没初始化，先跑：openclaw onboard --mode local

3. 启动 Gateway：openclaw gateway --port 18789

4. 再开一个新的终端窗口，先查 Mac 的局域网 IP：ipconfig getifaddr en0，返回类似：192.168.1.23

5. 执行：openclaw qr --url ws://192.168.1.23:18789（把里面的 IP 换成你自己 Mac 查出来的 IP）

官方 CLI 文档里，openclaw qr 就是用来生成移动端配对二维码和 setup code 的命令，也支持 --url 指定 Gateway 地址。

1. 打开手机 OpenClaw App
2. 直接选择 Connect Gateway，并点击Scan QR Code扫描 Mac 终端里生成的二维码。（或者点击 setting 选择 scan qp）

七、批准手机设备配对

手机第一次连接 Gateway 时，Mac 端需要批准这个设备。

在 Mac 终端新开一个窗口，执行：openclaw devices list

你会看到一个 pending 的设备请求，里面有一个 requestId。

批准它：openclaw devices approve <requestId>

如果不想批准，可以拒绝：openclaw devices reject <requestId>

官方 pairing 文档说明，iOS、Android、macOS、headless nodes 都会以 role: node 的方式连接 Gateway，首次连接需要 Gateway 创建并批准设备配对请求。

批准后，再检查节点状态： openclaw nodes status或者：openclaw gateway call node.list --params "{}"

如果能看到手机节点在线，说明连接成功。

八、通过 Telegram 生成手机配对码

如果你已经把 Telegram Bot 接入 OpenClaw，也可以用 Telegram 做首次配对。

步骤如下：

1. 在 Telegram 里给你的 OpenClaw Bot 发送：/pair

2. Bot 会返回一条说明和一个 setup code

3. 打开手机 OpenClaw App

4. 进入：Settings 选择 Gateway

5. 扫描二维码，或者粘贴 setup code

6. 回到 Telegram，输入：/pair pending

7. 查看待批准设备，然后批准

官方文档推荐 iOS 用户通过 Telegram 进行首次设备配对；setup code 本质上是一个包含 Gateway WebSocket 地址和短期 bootstrap token 的编码 payload，所以有效期内要像密码一样保管。

九、常见问题排查

1. 手机搜不到 Mac Gateway

先确认 Mac 和手机在同一个 Wi-Fi。

然后确认 Mac Gateway 是否启动：openclaw gateway --port 18789 --verbose

再确认 Mac 的 IP：ipconfig getifaddr en0

最后在手机里手动填写：ws://你的Mac局域网IP:18789

例如：ws://192.168.1.23:18789

2. 连接后一直 pending

在 Mac 上执行：openclaw devices list

如果看到 pending 请求，批准：openclaw devices approve <requestId>

批准后再查：openclaw nodes status

3. Mac 上 openclaw 命令不存在

先检查 npm 全局路径：npm bin -g echo $PATH

如果 PATH 没包含 npm 全局路径，可以临时执行：export PATH="$(npm bin -g):$PATH"

如果还是不行，重新安装：npm install -g openclaw@latest

4. 手机和 Mac 不在同一网络

如果手机不在同一个局域网，比如你人在外面，Mac 在家里，就不能直接用普通 ws://192.168.x.x:18789。

这种场景推荐用：Tailscale Serve / Funnel

或者其他带 TLS 的公网 wss:// Gateway 地址。

Android 官方文档明确说明，Tailscale 或公网主机建议使用安全端点，例如 wss://，而不是直接使用裸的 tailnet IP ws://。

总结

OpenClaw 的正确理解方式不是“又一个聊天软件”，而是一个 本地 Gateway + 多端节点 + 多模型 + 多工具 的 AI 助手系统。

Mac 负责运行 Gateway。 手机 App 负责作为移动节点接入。 模型负责思考和生成。 聊天入口负责和你交互。

如果只是想聊天，普通 ChatGPT、Grok、Claude App 就够了。

但如果你想把手机、Mac、聊天软件、模型和本地工具串成一个能执行任务的 AI 系统，OpenClaw 才真正有意义。