首页 > 专题 > OpenClaw专栏 > 文章详情
返回 OpenClaw专栏

OpenClaw 安装指南：5分钟快速部署开源AI助手

2026年03月11日 9 阅读 OpenClaw专栏

OpenClaw 安装手册

一、安装前的准备：环境与凭证

在开始安装前，请确保你的设备和账号满足以下要求，这能避免后续80%的安装问题。

1.1 系统要求

OpenClaw的核心运行环境是 Node.js，对操作系统也有明确要求。

  • Node.js版本：必须 ≥ 22。你可以在终端执行 node -v 检查版本。
  • 操作系统：
    • macOS / Linux：原生支持，体验最佳。
    • Windows：强烈推荐使用 WSL2 (Windows Subsystem for Linux 2)。官方对Windows原生环境的支持有限，容易遇到权限和路径问题。如果坚持使用原生Windows，请确保系统为Windows 10/11专业版，并已开启开发者模式。
  • 硬件建议：至少2GB内存是基础，若要流畅运行多个"技能"(Skills)，建议4GB或更高。

1.2 核心凭证

OpenClaw本身不包含大模型，需要接入外部模型服务才能思考和对话。

  • 大模型 API Key：你需要提前注册一个模型服务商（如阿里云百炼、七牛云、Moonshot AI (Kimi)等），并在其控制台创建并获取API Key。这是让OpenClaw"活"起来的关键。
  • （可选）云平台账号：如果选择云端部署（推荐），需注册阿里云、华为云等账号并完成实名认证。

1.3 ⚠️ 重要提醒：隐私安全

OpenClaw作为强大的自动化工具，有权限执行系统命令和访问文件。

  • 安全建议：如果你的主力电脑存有重要的商业或个人隐私信息，强烈建议弄一台干净的备用设备，或者直接租用一个云端虚拟机（VPS）来运行。

二、安装方式：四种方案任你选

OpenClaw提供了多种安装方式以适应不同用户的需求。考虑到国内网络环境，推荐前两种方案。

方案A：一键安装脚本（官方推荐，新手首选）

这是最简单、最快捷的方式，脚本会自动检测操作系统、安装依赖，并将openclaw命令部署到全局。

  • Windows (PowerShell)：以管理员身份打开 PowerShell，执行： 
    iwr -useb https://openclaw.ai/install.ps1 | iex
  • macOS / Linux (Terminal)： 
    curl -fsSL https://openclaw.ai/install.sh | bash

脚本执行后，通常会自动进入新手引导（onboard）界面。如果未进入，可手动执行 openclaw onboard 启动。

方案B：手动全局安装（适合已有Node.js环境，需注意网络问题）

如果你已安装Node.js环境，或需要通过配置镜像加速下载，可以选择此方式。

  • 配置npm国内镜像（关键步骤，大幅提升下载速度和成功率）： 
    npm config set registry https://registry.npmmirror.com
  • 全局安装OpenClaw： 
    npm install -g openclaw@latest
  • 避坑：若遇到sharp模块安装失败，请使用以下命令强制安装预编译二进制文件，绕过本地编译： 
    SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
  • 验证安装：openclaw --version 。

方案C：Windows + WSL2 详细部署（兼顾性能与兼容性）

这是官方推荐的Windows运行方式，能获得接近Linux原生的体验。

  1. 启用WSL2：以管理员身份打开PowerShell，执行 wsl --install，然后重启电脑。
  2. 进入WSL环境：重启后打开PowerShell，输入 wsl 进入Linux子系统。
  3. 执行安装：在WSL终端中，你可以使用方案A的一键安装脚本，或方案B的手动安装（推荐在WSL内也配置npm镜像）。

方案D：中文社区版 (openclaw-cn) - 国内网络环境最优解

这是一个由社区维护的中文版本，将所有依赖打包为npm包，完美适配国内网络环境。

  1. 配置npm国内镜像（同上）。
  2. 全局安装openclaw-cn： 
    npm install -g openclaw-cn@latest
  3. 运行安装向导： 
    openclaw-cn onboard --install-daemon
  4. 启动网关： 
    openclaw-cn gateway --port 18789 --verbose

三、初始化配置（Onboarding）：让OpenClaw连上"大脑"

安装完成后，需要通过onboard向导进行核心配置。无论你使用哪种方式安装，这一步都必不可少。

  1. 启动向导：在终端执行 openclaw onboard 。
  2. 交互配置关键选项：
    • 风险提示：输入 Yes 确认理解安全风险。
    • 配置模式：选择 QuickStart 快速启动。
    • AI模型提供商：选择你拥有的API Key对应的服务商，如 Moonshot AI (Kimi) 或 Custom Provider（用于配置阿里云百炼等）。
    • API Key：粘贴你之前获取的API Key。
    • 聊天渠道：初次配置建议选择 Skip for now 跳过，后续再根据需要接入飞书、钉钉等。
    • 技能（Skills）：同样建议先 Skip for now 跳过，避免首次安装因下载插件而报错。

四、启动与验证

完成配置后，就可以启动OpenClaw并检查其健康状况了。

  1. 启动网关服务：openclaw gateway start 。这是OpenClaw的核心后台进程，必须保持运行。
  2. 运行诊断：openclaw doctor，进行全面健康检查。
  3. 查看状态：openclaw status，确认网关运行状态。
  4. 打开Web控制台：
    • 执行 openclaw dashboard，浏览器会自动打开http://127.0.0.1:18789/并填入临时Token。
    • 在对话界面发送消息，有回复即表示安装和配置成功。
教程OpenClaw