在 macOS 上部署 OpenClaw，附完整操作步骤

本文所有命令和配置均来自 OpenClaw 官方文档，适用于 macOS 12 及以上版本，Intel 和 Apple Silicon 均适用。

第一步：安装 Node.js 22

OpenClaw 要求 Node.js 22 或更高版本，先确认本机版本：

node --version

如果输出低于 v22.x.x 或提示命令不存在，按以下方式安装。

nvm 可以管理多个 Node 版本，后续切换方便，也不会有全局权限问题：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完关闭终端重开，或者手动 source 一下配置文件：

source ~/.zshrc

然后安装 Node 22：

nvm install 22
nvm use 22
node --version  # 确认输出 v22.x.x

如果已经装了 Homebrew：

brew install node@22

官方推荐用一键安装脚本，它会处理好依赖和路径问题：

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程中如果提示需要 Homebrew 来安装某些依赖，按提示确认即可。脚本会自动处理。

安装完验证：

openclaw --version

部分 Apple Silicon 机器上用 npm install -g openclaw 直接安装时，会在 sharp 依赖这里报错：

npm error sharp: Please add node-gyp to your dependencies

官方安装脚本通过设置 SHARP_IGNORE_GLOBAL_LIBVIPS=1 环境变量规避了这个问题，所以推荐用脚本安装。如果仍然报错，先安装 Xcode 命令行工具再重试：

xcode-select --install
curl -fsSL https://openclaw.ai/install.sh | bash

OpenClaw 需要你自己提供 LLM 的访问凭证，支持以下方式：

提供商	认证方式
Anthropic Claude（API Key）	在 console.anthropic.com 生成
Anthropic Claude（订阅用户）	用 setup-token，见下方说明
OpenAI	在 platform.openai.com 生成，或 OAuth
本地 Ollama	无需 Key，配置本地端点

Claude Pro / Max 订阅用户：如果你有 Claude 订阅但没有 API Key，先安装 Claude Code CLI，然后运行：

claude setup-token

复制生成的 token，在 onboard 引导里选 Anthropic → 认证方式选「token (paste setup-token)」粘贴即可。

加上 --install-daemon 参数，引导完成后会自动把 Gateway 注册为 macOS launchd 服务，开机自启：

openclaw onboard --install-daemon

引导会依次配置：

查看 Gateway 状态：

openclaw gateway status

打开控制面板：

openclaw dashboard

浏览器会打开 http://127.0.0.1:18789，在这里直接发消息，能收到 AI 回复就说明部署成功。

OpenClaw 提供了一个原生 macOS App，安装后会在菜单栏显示一个图标，方便快速访问 Gateway 和控制面板，不需要每次打开终端。

要求：macOS 15 及以上，支持 Intel 和 Apple Silicon 的 Universal Binary。

在 GitHub Releases 页面下载最新版本，解压后把 App 拖入应用程序文件夹即可。

App 的首次运行引导流程和 CLI 的 onboard 是同一套逻辑，如果你已经用 CLI 配好了，打开 App 后会自动读取现有配置。

接入 Telegram 之后可以随时用手机触发任务。

在 Telegram 搜索 @BotFather，发送 /newbot，按提示操作，最后复制 Bot Token。

openclaw channels add --channel telegram --token 你的BotToken

在 Telegram 里给你的 Bot 发一条消息，它会回复一个配对码。然后在终端审批：

openclaw pairing list telegram
openclaw pairing approve telegram <配对码>

配对码有效期 1 小时。配对完成后就可以在 Telegram 随时和 AI 对话了。