OpenClaw（前 Clawdbot / Moltbot）安装过程在大多数情况下通过一键脚本非常顺畅，但由于 Node.js 环境、权限、旧版本残留、系统差异等因素，仍然会出现一些高频错误。本文汇总了 GitHub Issues、官方文档、Reddit、Discord 和社区博客中最常见的安装/Onboarding 问题及实测有效的修复方法，按出现频率排序。
适用于 macOS、Linux（Ubuntu/Debian/Fedora）、Windows（WSL 或原生 PowerShell）用户。优先检查 Node.js 版本 和 权限，90% 的问题出在这两点。
错误表现：
症状关键词：node --version 显示 v18.x / v16.x / v14.x，或 v23+ / v24+
解决方法：
网站资讯
关于我们curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc # 或 ~/.zshrc
nvm install 22
nvm use 22
nvm alias default 22npm cache clean --force
curl -fsSL https://openclaw.ai/install.sh | bash错误表现：
解决方法（选一种，优先第1种）：
方案A：修改 npm 全局安装目录到用户目录（最推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc # 或 ~/.bashrc
source ~/.zshrc
npm install -g openclaw@latest方案B：使用 sudo（快速但不优雅）
sudo npm install -g openclaw@latest
# 之后 onboarding 不要用 sudo
openclaw onboard错误表现：
解决方法：
winget install git.git
# 关闭所有 PowerShell 窗口，重新以管理员打开，再运行
iwr -useb https://openclaw.ai/install.ps1 | iexnpm install -g openclaw@latestRemove-Item "$env:TEMP\OpenClaw\*" -ErrorAction SilentlyContinue错误表现：
解决方法：
openclaw gateway status
sudo systemctl status openclaw-gateway # Linux systemdopenclaw gateway install --force
openclaw gateway restartopenclaw token create --name default --expires-in 365d
# 把新 token 填到 ~/.openclaw/openclaw.json 的 gateway.auth.token
openclaw gateway restartopenclaw config set gateway.mode local错误表现：
解决方法：
mkdir -p ~/.openclaw
sudo chown -R $USER:$USER ~/.openclawgit clone https://github.com/openclaw/openclaw
cd openclaw/docker
docker compose up -d
docker compose run --rm openclaw-cli onboard错误表现：
解决方法（Linux）：
sudo apt update
sudo apt install -y chromium-browser libnss3 libatk-bridge2.0-0 ...错误表现：
解决方法：
node --version # 必须 v22.x
npm --version
which node # 确认路径
openclaw --version # 已安装？
openclaw gateway status
journalctl -u openclaw-gateway -n 50 # Linux 日志
openclaw logs # CLI 日志
cat ~/.openclaw/openclaw.json # 检查 config
