openclaw部署运行

第一步：验证你的 Node.js 版本

先打开终端，输入这个命令：

node --version

系统需要v22.0.0或更高版本。如果返回的版本号太旧，或者显示“command not found”，别担心——安装程序会自动帮你搞定Node.js的安装。

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

第二步：运行安装脚本

接下来执行这条命令，它会下载并运行官方安装程序：

curl -fsSL https://openclaw.ai/install.sh | bash

整个过程都是自动化的：脚本会先验证系统要求，然后下载最新版OpenClaw（当前最新是v2026.2.6，发布于2026年2月7日），接着安装openclaw二进制文件，最后在~/.openclaw创建默认配置目录。有意思的是，不同系统的安装路径还不一样——macOS上会放在/usr/local/bin/openclaw，而Linux系统根据权限不同，可能选择/usr/local/bin/openclaw或~/.local/bin/openclaw。

第三步：运行引导向导

安装完成后，这个onboard命令会带你完成初始配置：

openclaw onboard

向导会逐步引导你输入三个关键信息：首选的大语言模型提供商（可选Anthropic Claude、OpenAI GPT、Google Gemini或本地Ollama模型）、对应的API密钥，以及第一个要连接的消息平台（支持WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Microsoft Teams或Google Chat）。你的每个选择都会在~/.openclaw/.env中生成对应的环境变量。

第四步：验证安装

最后用内置的诊断工具确认所有组件都正常连接：

openclaw doctor

健康的安装会输出确认信息，包括Node.js版本符合要求、配置文件有效、API密钥可访问、消息桥接正常运行。万一有任何检查失败，输出会包含具体的错误信息和修复建议。这个阶段最常见的坑就是API密钥无效或过期——建议先到提供商的控制台确认密钥状态，再继续排查其他问题。

报错信息：

! npm install failed for openclaw@latest

Command: env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --loglevel error --silent --no-fund --no-audit install -g openclaw@latest

Installer log: /tmp/tmp.cqGUAcO1VP

! npm install failed; showing last log lines

! npm install failed; retrying

! npm install failed for openclaw@latest

Command: env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --loglevel error --silent --no-fund --no-audit install -g openclaw@latest

Installer log: /tmp/tmp.cft7EBZjWp

! npm install failed; showing last log lines

遇到安装失败时，可以试试这个变通方案：

npm install -g openclaw@beta

对了，记得确保网络环境畅通。

国内用户可以使用镜像源下载：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@beta --progress=true

如果想了解更多细节，推荐参考这个详细教程：OpenClaw安装教程：Mac和Windows保姆级部署指南 • StableLearn | 让AI成为你的超能力