OpenClaw 完整安装教程（2026 全平台通用版）

OpenClaw 完整安装教程（2026 全平台通用版）：从环境准备到 GLM-4.6 模型接入

1. OpenClaw 是什么 & 环境要求

OpenClaw 是一款功能强大的 AI 助手工具，支持本地部署，可以接入 GLM-4.6、Claude 等多种大模型，实现代码辅助、自动化工作流等核心能力。它最大的特点是部署在自己的机器上，数据可控、模型可选。

支持平台：

macOS 12+
Linux（Ubuntu 20.04+、Debian 11+、Fedora 38+）
Windows 10 / 11

硬性要求：Node.js v20+（推荐 v22 LTS）。安装前先确认自己的系统满足这些条件，否则后续步骤可能失败。

2. 安装 Node.js（全平台）

macOS

bash 复制代码

brew install node@22

Linux（Ubuntu / Debian）

bash 复制代码

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

Windows

到 Node.js 官网下载安装包，一路下一步即可：

text 复制代码

https://nodejs.org/zh-cn/download/

验证安装

bash 复制代码

node -v
npm -v

两个命令都能输出版本号，说明 Node.js 安装成功。

3. 三种安装方式（按需选一种）

方式一：一键安装（新手首选）

macOS / Linux：

bash 复制代码

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

Windows（管理员 PowerShell）：

以管理员身份运行 PowerShell：按 Win 键 → 搜索 PowerShell → 右键选择"以管理员身份运行" → 点击"是"确认。

先执行两条命令设置执行策略：

powershell 复制代码

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

这两条命令的作用都是允许当前用户运行本地和下载的脚本。它们只影响你自己的账户，不会影响系统安全或其他用户。

然后执行安装命令：

powershell 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

方式二：npm 手动安装

macOS / Linux：

bash 复制代码

sudo npm install -g openclaw@latest

Windows：

bash 复制代码

npm install -g openclaw@latest

macOS 常见坑：sharp 安装失败

如果你在 macOS 上安装时遇到 sharp 相关的报错，可以加一个环境变量绕过全局的 libvips 依赖：

bash 复制代码

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

验证安装：

bash 复制代码

openclaw --version

方式三：Docker 部署

如果你机器上装了 Docker，也可以用容器方式运行，环境隔离最干净：

bash 复制代码

docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

这条命令的含义：启动名为 openclaw 的容器，把宿主机的 3000 端口映射到容器，同时把本地的 ~/.openclaw 数据目录挂载进容器，这样数据不会随容器销毁而丢失。

4. 初始化配置（必做）

安装完成后，第一次使用必须执行初始化向导：

bash 复制代码

openclaw onboard

按提示一步步配置：

风险告知：向导会提示使用 OpenClaw 可能存在风险。按左方向键选择 Yes，按 Enter 确认。
选择配置模式：选择 QuickStart 模式配置 AI 模型 API Key。
配置 GLM-4.6/4.7（重点步骤）：输入智谱 AI 的 API Key。需要先到智谱开放平台注册登录，进入 API 密钥管理，创建一个密钥，然后填入这里。
连接通讯平台：向导会询问要连接哪个通讯平台（如 Slack、Discord 等），暂时跳过，选择 skip for now。
Skills 选择：选择 NO，暂时不启用。
Hooks：选择 skip for now，跳过。

配置完成后，启动服务并打开 UI 界面，就大功告成了。

5. 启动与使用

OpenClaw 运行需要两个窗口配合：

窗口 A：执行 openclaw gateway 启动网关，保持这个窗口打开
窗口 B：执行 openclaw dashboard 启动控制台，会自动打开网页

Web 控制台地址：

text 复制代码

http://localhost:3000

为了方便，这里提供一个 Windows 一键启动脚本。桌面新建一个 txt 文件，复制下面的代码，然后把后缀名改成 OpenClaw 网关启动.bat，双击运行即可：

bat 复制代码

@echo off
echo Using Node v22.12.0 via nvm...
nvm use 22.12.0 >nul

echo Starting OpenClaw Gateway...
openclaw gateway start

6. 常见问题排查

权限不足

macOS / Linux：在命令前面加 sudo
Windows：用管理员终端运行

sharp 安装失败（macOS）

先安装系统级的 vips 依赖，再重新安装 OpenClaw：

bash 复制代码

brew install vips
npm install -g openclaw@latest

模型调用失败

检查 API Key、Base URL、模型名是否配置正确
执行 openclaw restart 重启服务

7. 总结

到这里，一个可用的 OpenClaw 就装好了。完整链路是：装 Node.js → 选一种方式装 OpenClaw → 执行 onboard 配置 GLM-4.6 → 启动 gateway + dashboard → 在 Web 控制台使用。

配置完成后，你就可以在本地 Web 控制台或 VS Code 中调用 GLM-4.6 等模型，实现 AI 辅助开发、自动化工作流等场景。遇到问题先按第六章排查，大多数问题都是权限、依赖或 API Key 配置引起的。