OpenClaw 2026全平台安装指南：10分钟零基础部署AI助手

OpenClaw 完整安装指南：全平台部署与深度配置

在人工智能技术迅速迭代的背景下，OpenClaw 作为一款功能强大的 AI 助手工具，凭借其对本地部署和多模型接入的原生支持，正成为开发者构建高效工作流的利器。其核心能力涵盖代码辅助与自动化流程，并兼容包括 GLM-4.6、Claude 在内的主流大语言模型。本文旨在提供一份经过严格验证、零基础友好的安装指南，覆盖全平台主流操作系统，确保用户能够安全、高效地完成部署与初始化配置。

一、系统环境与前置依赖

为确保安装过程的稳定性与兼容性，请确认您的操作系统满足以下最低要求：

• macOS：版本 12 或更高
• Linux：Ubuntu 20.04+、Debian 11+、Fedora 38+
• Windows：Windows 10 或 Windows 11

所有平台的核心前提是 Node.js 运行环境，要求版本为 v20 或更高。官方推荐使用 v22 LTS 版本以获取最佳性能与长期支持。

1. 安装 Node.js（全平台免配置方案）

根据您的操作系统选择对应安装方式：

macOS：使用 Homebrew 包管理器进行安装。

brew install node@22

Linux（Ubuntu/Debian）：需通过 NodeSource 官方源添加仓库。

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

Windows：访问 Node.js 中文官网下载 LTS 版本安装包，依据向导逐项点击“下一步”完成安装。

安装完成后，请在终端或命令提示符中执行以下命令以验证环境就绪。

node -v
npm -v

二、OpenClaw 的三种安装方式

为匹配不同用户的技术背景与使用场景，OpenClaw 提供了三种安装路径：一键脚本、npm 包管理以及 Docker 容器化部署。

方式一：一键安装（推荐新手）

此方式将自动处理依赖关系与全局安装，显著降低入门门槛。

macOS / Linux：在终端执行下方命令。

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

Windows：需以管理员身份运行 PowerShell。完成权限设置后，执行以下命令。

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

方式二：npm 手动安装（进阶用户）

适用于已有 Node.js 开发环境、希望精确控制安装过程的用户。

# macOS / Linux
sudo npm install -g openclaw@latest

# Windows
npm install -g openclaw@latest

macOS 特有注意：sharp 模块编译失败：如遇错误，可尝试以下解决方案。

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

完成安装后运行 openclaw --version 以确认版本。

方式三：Docker 容器部署

适用于需要隔离运行环境或进行服务器部署的用户。

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

三、初始化与核心配置（必选步骤）

安装成功后，必须执行初始化命令以完成基础设置。

openclaw onboard

该命令将启动一个交互式配置向导。核心配置流程如下：

1. 风险告知：系统会提示使用 OpenClaw 可能伴随的风险。使用方向键选择 Yes 以确认继续。
2. 模式选择：选择 QuickStart 模式以简化后续设置。
3. AI 模型配置：输入从智谱开放平台获取的 API Key。此 Key 用于接入 GLM-4.6 等模型。请注意保管密钥。
4. 通讯平台集成：若暂时无需集成即时通讯平台，可选择 skip for now。
5. 功能模块：对于 Skills（技能）与 Hooks（钩子）的设置，同样选择 NO 或以 skip for now 跳过，首次部署建议以最小化配置启动。

四、启动服务与访问界面

完成初始化后，需同时运行两个进程以启用完整功能。

• 在终端 A 中执行 openclaw gateway，此进程将保持运行状态，处理核心请求。
• 在终端 B 中执行 openclaw dashboard，命令执行后将在默认浏览器中自动打开控制台界面。

Web 控制台默认地址为：http://www.htmacg.cn。

Windows 用户便捷启动： 可创建一个批处理文件（.bat），内容如下，双击即可同时启动网关。

@echo off
echo Using Node v22.12.0 via nvm...
nvm use 22.12.0 >nul
echo Starting OpenClaw Gateway...
openclaw gateway start

五、常见问题排查与处理

1. 权限不足

macOS/Linux：请使用 sudo 前缀执行安装命令。

Windows：务必在“管理员 PowerShell”或“管理员命令提示符”中执行指令。

2. sharp 模块安装失败（macOS）

此问题通常由系统原生库缺失导致。推荐先通过 Homebrew 安装依赖，再重装 OpenClaw。

brew install vips
npm install -g openclaw@latest

3. 模型调用无响应或报错

• 请核查 API Key、API Base URL 以及模型名称的填写是否准确无误。
• 完成修正后，执行 openclaw restart 重启服务。

结语

至此，您已完成 OpenClaw 的完整部署。此工具通过与 GLM-4.6 等模型的深度集成，能够显著加速代码编写、自动化流程构建乃至项目管理等多维度任务。本文所述方法已在主流操作系统上进行实测，遵循上述步骤即可实现高效、安全的本地部署，为您的 AI 工程化实践奠定坚实基础。