基础环境准备
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 用户账户来运行,并遵循最小权限原则,避免对主系统造成意外影响。

