基础环境准备
要跑通 OpenClaw，Node.js 环境是基石。建议直接使用 LTS 版本，如果当前版本低于 22，最好用 nvm 重新装一个。
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 加载 nvm
. "$HOME/.nvm/nvm.sh"
# 安装并使用 Node.js 24.x
nvm install 24
nvm use 24
# 检查版本
node -v && npm -v
安装 OpenClaw
环境就绪后，直接通过 npm 全局安装即可。Mac 下可能需要输入开机密码授权。
sudo npm install -g openclaw@latest
openclaw --version
官方也提供了一键脚本，如果你更习惯这种方式，也可以试试：
curl -fsSL https://openclaw.ai/install.sh | bash
初始化配置
安装完成后，运行 onboard 命令开始向导。加上 --install-daemon 参数可以让后台服务自动启动，方便后续调用。
openclaw onboard --install-daemon
向导里会问几个关键问题：
- 安全确认：勾选 Yes 表示你了解潜在风险。
- 快速模式：选 QuickStart 最省心。
- 模型接入：这里需要填 API Key，比如 Kimi 或通义千问，记得从对应平台获取。
- 渠道绑定：新手建议先跳过飞书、Telegram 等外部渠道，先把核心功能跑起来再说。
验证与启动
配置完就能用了。终端敲下这个命令，浏览器会自动打开控制台：
openclaw dashboard
地址通常是 http://127.0.0.1:18789/。试着发一句'介绍一下你的核心功能'，如果有回复，说明本地部署成功。
安全建议
OpenClaw 权限较高，为了保险起见，建议在 macOS 上创建一个独立的用户账户来运行它，遵循最小权限原则，别让它动到你的主系统文件。
