OpenClaw（原名 Clawdbot/Moltbot）是2026年初爆火的开源个人AI助手，可以部署在本地运行。

🦐 OpenClaw 完整安装教程（2026年最新版）

一、系统要求

二、安装方式（三种任选）

🔹 方式一：npm/pnpm 全局安装（最简单）

1. 安装 Node.js

# 访问官网下载：https://nodejs.org/
# 或使用 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

2. 安装 OpenClaw

# 使用 npm
npm install -g openclaw@latest

# 或使用 pnpm（更快，推荐）
pnpm add -g openclaw@latest

3. 启动配置向导

openclaw onboard --install-daemon

4. 访问 Web 控制台

浏览器打开：http://127.0.0.1:18789/

🔹 方式二：源码部署（适合开发者）

# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 安装依赖（推荐 pnpm）
pnpm install

# 3. 构建项目
pnpm build

# 4. 运行 onboarding 向导
pnpm openclaw onboard --install-daemon

🔹 方式三：Docker 部署（适合隔离环境）

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/app/data \
  openclaw/openclaw:latest

三、不同系统注意事项

🪟 Windows 用户

1. 1. 以管理员身份运行 PowerShell
2. 2. 安装 VS Build Tools（解决 node-gyp 编译问题）
• • 下载地址：https://visualstudio.microsoft.com/visual-cpp-build-tools/
3. 3. 执行策略设置：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

🍎 macOS 用户（尤其是 M1/M2/M3）

1. 1. 确保 Node.js 是 ARM64 原生版本：

   node -p "process.arch"  # 应输出 arm64

2. 2. 如输出 x64，需重新安装 ARM64 版本的 Node.js

🐧 Linux/Ubuntu 用户

# 安装必要依赖
sudo apt update
sudo apt install -y build-essential cmake python3

# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

四、配置大模型

OpenClaw 支持多种大模型，配置方法：

1. 1. 打开 Web 控制台 http://127.0.0.1:18789/
2. 2. 进入 Settings → AI Models
3. 3. 添加模型 API Key（支持）：
• • OpenAI
• • Anthropic Claude
• • 阿里云 Qwen
• • 本地 Ollama
• • 其他兼容 OpenAI API 的模型

五、常用命令

六、故障排除

七、官方资源

• • 🌐 官网：https://openclaw.ai/
• • 📚 文档：https://docs.openclaw.ai/
• • 💻 GitHub：https://github.com/openclaw/openclaw
• • 💬 社区：Discord / Telegram 群组

⚠️ 重要提示

1. 1. OpenClaw 更新频繁（可能半个月一个版本），建议定期更新
2. 2. 权限较高，建议单独服务器或虚拟机运行
3. 3. 数据本地存储，注意备份配置文件
4. 4. 最新稳定版可通过 openclaw update 命令更新

如有具体安装问题，欢迎告诉我您的操作系统和遇到的错误信息，我可以提供更针对性的帮助！🦐