OpenClaw 可以理解成一个“本地 AI 助手网关”。它不是单纯的聊天机器人，而是把模型、工具、设备和聊天入口串起来：你可以在电脑上运行 Gateway，再用 Telegram、WhatsApp、Slack、Discord、Signal、iMessage，或者手机 OpenClaw App 接入它。官方首页对它的定位是：在你常用的聊天软件里，让 AI 帮你处理邮件、日程、任务等操作。
这篇教程以 Mac 安装 OpenClaw + 手机 OpenClaw App 连接 Gateway为主。
一、准备工作
你需要准备：
- 一台 Mac
- 一个可用网络
- 终端 Terminal
- 手机 OpenClaw App 手机 OpenClaw 应用程序
- 一个可用模型，例如 Grok / xAI、OpenAI、Anthropic 等
- 如果要接 Grok，建议准备 SuperGrok 或 X Premium 订阅（ SuperGrok 官方订阅升级服务：http://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 渠道分发，本地开发者也可以从源码构建。
- 打开 Mac 终端，先确认 OpenClaw 能用：
openclaw --version - 如果还没初始化，先跑：
openclaw onboard --mode local - 启动 Gateway：
openclaw gateway --port 18789 - 再开一个新的终端窗口，先查 Mac 的局域网 IP：
ipconfig getifaddr en0，返回类似：192.168.1.23 - 执行：
openclaw qr --url ws://192.168.1.23:18789（把里面的 IP 换成你自己 Mac 查出来的 IP）
官方 CLI 文档里，
openclaw qr就是用来生成移动端配对二维码和 setup code 的命令，也支持--url指定 Gateway 地址。
- 打开手机 OpenClaw App
- 直接选择 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 做首次配对。
步骤如下：
- 在 Telegram 里给你的 OpenClaw Bot 发送：
/pair - Bot 会返回一条说明和一个 setup code
- 打开手机 OpenClaw App
- 进入：
Settings 选择 Gateway - 扫描二维码，或者粘贴 setup code
- 回到 Telegram，输入：
/pair pending - 查看待批准设备，然后批准
官方文档推荐 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 才真正有意义。