MacOS安装OpenClaw
在MacOS上安装OpenClaw，核心是安装nodejs和openclaw，以及在安装完成后进行初始话配置。
安装要求
- Node 24（推荐）（出于兼容性考虑，仍支持 Node 22 LTS，目前为 22.16+；）
- macOS 支持
- 仅当你从源码构建时需要 pnpm（推荐不安装）
安装 Node.js
在 MacOS 上安装 Node.js 时，默认都会包含 node 和 npm 两个工具命令。
安装方法有很多，比如：
- Homebrew安装： Homebrew是Mac上常用的包管理工具，类似Linux的 yum/apt。但是homebrew安装包需要访问GitHub。
- Nvm 安装： Nvm是 Node.js 的版本管理工具，可以安装和升级 node 版本。但是nvm自身安装依赖homebrew或访问GitHub。
- 官方安装脚本： 官方默认安装脚本，也是先安装 nvm，需要访问GitHub
raw.githubusercontent.com。 - （推荐）官方安装包下载安装： 官方还提供了PKG安装包，可以离线安装。
nodejs官网可正常访问，因此可以直接访问官网下载 MacOS 版本的 node 安装包。 https://nodejs.org/zh-cn/download
选择安装包并下载：
- 在页面上方选择 Node.js 版本，推荐选择
v24.14.1 LTS版本。 - 在页面下方选择个人电脑的操作系统（macOS）和CPU架构（新版本M系列的Mac都是ARM64架构，老版本的是x64架构）
双击下载的 pkg 安装包，全程按照默认“继续”进行安装即可
以后提示安装成功和的位置，点击关闭即可。
安装完成后进行验证。
默认安装路径为 /usr/local/bin/node 和 /usr/local/bin/npm 这个路径在 macOS 上是一般是添加到环境变量的，默认安装成功后就可以直接使用命令node和npm进行操作了。
% node -v
v24.14.1
% npm -v
11.11.0
如果（没有则忽略） 已经通过 Homebrew 安装过 Node.js，homebrew默认安装在 /opt/homebrew/ 路径下，可以通过指定路径进行验证。
一般建议保留一种安装方式即可，多种方式安装可能会造成后续管理上的困难。
% /usr/local/bin/node -v
v24.14.1
% /usr/local/bin/npm -v
11.11.0
安装 OpenClaw
OpenClaw 是基于 Node.js 实现的，因此默认就会发布到 npm 仓库中。
NPM官方仓库在国内无法直接访问或者网络很慢，可以通过国内的镜像源进行加速。
安装 OpenClaw 命令如下：
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
或
/usr/local/bin/npm install -g openclaw@latest --registry=https://registry.npmmirror.com
安装没有报错就是安装成功，一般会有如下的输出。
added 460 packages in 32s
84 packages are looking for funding
run `npm fund` for details
安装成功后，执行 openclaw -v 有版本输出则说明安装成功了。
% openclaw -v
OpenClaw 2026.3.24 (cff6dc9)
如果（没有则忽略） 有多种方式安装的 npm，则需要将OpenClaw的安装路径添加到环境变量中。
% echo $SHELL
/bin/zsh
% echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc && . ~/.zshrc
第一条命令是查看当前的shell，第二条命令是添加环境变量。如果是 /bin/bash ，则需要将 ~/.zshrc 替换为 ~/.bashrc。
初始化
OpenClaw 安装完后，一般需要进行初始化配置。
其核心就是通过交互式引导，完成一些配置，生成 ~/.openclaw/openclaw.json 文件，如果熟悉该文件内容，也可以直接创建该文件，不需要进行交互式初始化。
openclaw onboard --install-daemon
交互式初始化过程说明：
- 安全警告，选择
yes。通过键盘左右键选择，回车确认。◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? │ ● Yes / ○ No - 设置运行模式模式，选择默认的
QuickStart。通过上下键选择，回车确认。
确认后进行默认的配置。默认的配置只能通过本地环回接口访问（localhost/127.0.0.1），如果需要跨机器访问，也可以在后续修改配置文件。◆ Setup mode │ ● QuickStart (Configure details later via openclaw configure.) │ ○ Manual◇ QuickStart ─────────────────────────╮ │ │ │ Gateway port: 18789 │ │ Gateway bind: Loopback (127.0.0.1) │ │ Gateway auth: Token (default) │ │ Tailscale exposure: Off │ │ Direct to chat channels. │ │ │ ├──────────────────────────────────────╯ - 模型提供商配置，选择最后一个
Skip for now跳过配置。提供大模型服务的厂商，后续单独进行模型配置。◆ Model/auth provider │ ○ Anthropic │ ○ BytePlus │ ○ Chutes │ ○ Cloudflare AI Gateway │ ○ Copilot │ ○ Custom Provider │ ○ DeepSeek │ ○ Google │ ○ Hugging Face │ ○ Kilo Gateway │ ○ Kimi Code │ ○ LiteLLM │ ○ MiniMax │ ○ Mistral AI │ ○ Moonshot AI (Kimi K2.5) │ ○ Ollama │ ○ OpenAI │ ○ OpenCode │ ○ OpenRouter │ ○ Qianfan │ ○ Qwen │ ○ Qwen (Alibaba Cloud Model Studio) │ ○ SGLang │ ○ Synthetic │ ○ Together AI │ ○ Venice AI │ ○ Vercel AI Gateway │ ○ vLLM │ ○ Volcano Engine │ ○ xAI (Grok) │ ○ Xiaomi │ ○ Z.AI │ ● Skip for now - 模型列表提供商，选择默认
All providers。这个配置后续配置模型时会镜像修改，主要用于在Web页面聊天窗口切换模型列表的选项。◆ Filter models by provider │ ● All providers │ ○ amazon-bedrock │ ○ anthropic │ ○ azure-openai-responses │ ○ cerebras │ ○ github-copilot │ ○ google │ ○ google-antigravity │ ○ google-gemini-cli │ ○ google-vertex │ ○ groq │ ○ huggingface │ ○ kimi-coding │ ○ minimax │ ○ minimax-cn │ ○ mistral │ ○ ollama │ ○ openai │ ○ openai-codex │ ○ opencode │ ○ opencode-go │ ○ openrouter │ ○ vercel-ai-gateway │ ○ xai │ ○ zai - 设置默认模型，选择一个模型作为默认模型，回车确认。这里主要是配置默认模型，后续调用模型时，如果没有指定模型，则使用默认模型。该配置后续会覆盖修改。
◆ Default model │ ● Keep current (default: anthropic/claude-opus-4-6) │ ○ Enter model manually │ ○ amazon-bedrock/anthropic.claude-3-haiku-20240307-v1:0 │ ○ amazon-bedrock/anthropic.claude-3-5-haiku-20241022-v1:0 │ ○ amazon-bedrock/anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/eu.anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/anthropic.claude-opus-4-20250514-v1:0 ...... - 配置IM渠道，选择
Skip for now。这里主要是配置通过哪些渠道连接OpenClaw，如QQ、飞书、钉钉等，后面会单独进行配置。◆ Select channel (QuickStart) │ ○ Telegram (Bot API) │ ○ WhatsApp (QR link) │ ○ Discord (Bot API) │ ○ IRC (Server + Nick) │ ○ Google Chat (Chat API) │ ○ Slack (Socket Mode) │ ○ Signal (signal-cli) │ ○ iMessage (imsg) │ ○ LINE (Messaging API) │ ○ Feishu/Lark (飞书) │ ○ Nostr (NIP-04 DMs) │ ○ Microsoft Teams (Teams SDK) │ ○ Mattermost (plugin) │ ○ Nextcloud Talk (self-hosted) │ ○ Matrix (plugin) │ ○ BlueBubbles (macOS app) │ ○ Zalo (Bot API) │ ○ Zalo (Personal Account) │ ○ Synology Chat (Webhook) │ ○ Tlon (Urbit) │ ○ Twitch (Chat) │ ● Skip for now (You can add channels later via `openclaw channels add`) - 配置Web搜索服务，选择
Skip for now跳过。部分搜索需要注册配置APKEY才能使用，后续可单独配置。◆ Search provider │ ○ Brave Search │ ○ DuckDuckGo Search (experimental) │ ○ Exa Search │ ○ Firecrawl Search │ ○ Gemini (Google Search) │ ○ Grok (xAI) │ ○ Kimi (Moonshot) │ ○ Perplexity Search │ ○ Tavily Search │ ● Skip for now (Configure later with openclaw configure --section web) - 配置SKILL，选择
No。OpenClaw会有一些默认安装的SKILL，额外的SKILL可以通过 ClawHub 进行查询和安装，后续按需安装即可。◆ Configure skills now? (recommended) │ ○ Yes / ● No - 启动哪些hooks，选择第一个
Skip for now。通过键盘上的空格键进行选择，然后回车。hooks用于OpenClaw和大模型沟通过程中添加的额外信息。◆ Enable hooks? │ ◼ Skip for now │ ◻ 🚀 boot-md │ ◻ 📎 bootstrap-extra-files │ ◻ 📝 command-logger │ ◻ 💾 session-memory - 使用哪种方式访问OpenClaw？选择
Open the Web UI就会自动打开浏览器访问OpenClaw页面。◆ How do you want to hatch your bot? │ ○ Hatch in TUI (recommended) │ ● Open the Web UI │ ○ Do this later - 完成后的信息，输出完成后就会退出初始化步骤。
◇ Dashboard ready ────────────────────────────────────────────────────────────────╮ │ │ │ Dashboard link (with token): │ │ http://127.0.0.1:18789/#token=5040bd14cd0d8f838f83bd41226a598ba2a4d347428ec67d │ │ Opened in your browser. Keep that tab to control OpenClaw. │ │ │ ├──────────────────────────────────────────────────────────────────────────────────╯ │ ◇ Workspace backup ────────────────────────────────────────╮ │ │ │ Back up your agent workspace. │ │ Docs: https://docs.openclaw.ai/concepts/agent-workspace │ │ │ ├───────────────────────────────────────────────────────────╯ │ ◇ Security ──────────────────────────────────────────────────────╮ │ │ │ Running agents on your computer is risky — harden your setup: │ │ https://docs.openclaw.ai/security │ │ │ ├─────────────────────────────────────────────────────────────────╯ │ ◇ Shell completion ───────────────────────────────────────────────────────╮ │ │ │ Shell completion installed. Restart your shell or run: source ~/.zshrc │ │ │ ├──────────────────────────────────────────────────────────────────────────╯ │ ◇ Web search ───────────────────────────────────────╮ │ │ │ Web search was skipped. You can enable it later: │ │ openclaw configure --section web │ │ │ │ Docs: https://docs.openclaw.ai/tools/web │ │ │ ├────────────────────────────────────────────────────╯ │ ◇ What now ─────────────────────────────────────────────────────────────╮ │ │ │ What now: https://openclaw.ai/showcase ("What People Are Building"). │ │ │ ├────────────────────────────────────────────────────────────────────────╯ │ └ Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.
在MacOS系统上，可能会有一些权限提示，选择允许放开权限。在使用过程中会有更多的权限申请提示，请按需允许。
在第9步，选择浏览器打开后，默认就是自动打开 OpenClaw 的Web页面。
在MacOS安装完成后，打开浏览器默认就自动登录。
如果提示连接网关需要 Token。
Token 可以从安装完成最后的终端输出中获取，如 fcc68aaa7011034d4574b9b6d7c1572f90e603023e7bcebd。
在后续使用中如果忘记 Token，可以通过如下命令获取：
% cat ~/.openclaw/openclaw.json |grep token|grep -v mode
"token": "5040bd14cd0d8f838f83bd41226a598ba2a4d347428ec67d"