基础环境准备
本安装需要 Node.js v22+，如果版本过低建议按照以下步骤安装并应用。
1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
2. 让 nvm 命令生效
. "$HOME/.nvm/nvm.sh"
或者重启终端。
3. 安装并使用 Node.js LTS 版本
nvm install 24
nvm use 24
4. 验证安装
node -v
npm -v
安装 OpenClaw
全局安装 OpenClaw（可能需要输入 Mac 开机密码）：
sudo npm install -g openclaw@latest
验证安装成功：
openclaw --version
官方也提供了一键安装功能，可直接使用：
curl -fsSL https://openclaw.ai/install.sh | bash
初始化环境配置
启动初始化向导（建议加上 --install-daemon 安装后台服务）：
openclaw onboard --install-daemon
在向导中，按提示完成以下关键步骤：
- 确认安全提示：选择「Yes」以理解使用风险。
- 选择配置模式：选择「QuickStart」（快速开始模式），简单高效。
- 配置 AI 模型：这是核心步骤。选择一个模型服务商（如 Kimi、通义千问等），并输入从该平台获取的 API Key。
- 配置渠道和技能：建议新手暂时跳过渠道（如飞书、Telegram）和额外技能的安装，待基础环境跑通后再研究。
验证安装与启动
配置完成后，启动 OpenClaw 并验证其是否正常工作。
- 启动控制台：在终端运行
openclaw dashboard，浏览器会自动打开 OpenClaw 的 Web 控制台（通常是http://127.0.0.1:18789/）。 - 发送测试指令：在控制台的对话框里输入'介绍一下你的核心功能'。如果 AI 有正常回复，说明本地部署成功。
注意事项
- 从控制台开始：安装成功后，先通过 Web 控制台熟悉对话和操作方式，之后再根据需要配置外部渠道。
- 注意安全：OpenClaw 拥有较高的系统权限，建议为它创建一个独立的 macOS 用户账户来运行，并遵循最小权限原则，避免对主系统造成意外影响。
