基础环境准备
OpenClaw 基于 Node.js 构建，运行前请确保环境版本在 22 以上。如果当前版本过低，建议直接使用 nvm 进行切换。
首先安装 nvm 并加载环境变量：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
. "$HOME/.nvm/nvm.sh"
接着安装并使用 LTS 版本的 Node.js（例如 24.x）：
nvm install 24
nvm use 24
node -v
npm -v
看到版本号输出即表示环境就绪。
安装 OpenClaw
准备好环境后，可以通过 npm 全局安装 CLI 工具。由于涉及系统级写入，可能需要输入开机密码。
sudo npm install -g openclaw@latest
openclaw --version
官方也提供了一键脚本，若遇到 npm 问题可直接尝试：
curl -fsSL https://openclaw.ai/install.sh | bash
初始化配置
安装完成后，执行 onboard 命令启动向导。建议加上 --install-daemon 参数以安装后台服务，这样无需每次手动启动。
openclaw onboard --install-daemon
向导过程中有几个关键点需要注意：
- 安全确认：阅读提示后选择 Yes，理解潜在风险。
- 模式选择：新手推荐 QuickStart 快速开始模式。
- 模型配置：这是核心环节，需选择服务商（如 Kimi、通义千问等）并填入 API Key。
- 渠道跳过：飞书、Telegram 等外部渠道建议暂时跳过，待主流程跑通后再配置。
验证与启动
配置完毕后，即可启动 Web 控制台进行验证。
openclaw dashboard
浏览器会自动打开 http://127.0.0.1:18789/。在对话框中输入'介绍一下你的核心功能'，若 AI 正常回复，说明本地部署成功。
安全建议
OpenClaw 拥有较高的系统权限，为了保障数据安全，建议为它创建一个独立的 macOS 用户账户来运行，并遵循最小权限原则，避免对主系统造成意外影响。
