OpenClaw 提供三种安装方式:一键脚本安装(推荐新手)、npm 全局安装(推荐普通用户)、源码安装(推荐开发者)。三种方式均支持 macOS、Windows、Linux,Node.js 22+ 为必要前置条件。安装完成后通过 openclaw onboard 向导完成初始化,连接 LLM、配置通信渠道和技能即可开始使用。

 

安装前提条件

OpenClaw 要求 Node.js 版本 ≥ 22。 使用一键脚本安装时,脚本会自动检测并安装 Node.js,无需手动处理。使用 npm 或源码安装前,请先确认 Node.js 版本:

 

node --version  # 确认输出 v22.x.x 或更高

支持的操作系统:

 macOS(菜单栏应用需要 macOS 15+)

 Windows

 Linux

 

方法一:一键脚本安装(推荐新手)

这是 OpenClaw 官方最推荐的安装方式,自动处理 Node.js 依赖和平台差异:

 

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

脚本会自动完成:

1. 检测操作系统和现有环境

2. 安装或更新 Node.js(如未满足 ≥22 要求)

3. 全局安装 OpenClaw 最新版

4. 启动 onboard 向导

macOS 注意:首次运行可能需要 Homebrew 管理员权限,按提示输入密码即可。

 

方法二:npm 安装(推荐普通用户)

已有 Node.js 22+ 环境的用户,直接用 npm 安装最简洁:

 

npm install -g openclaw@latest
openclaw onboard --install-daemon

或使用 pnpm(速度更快):

 

pnpm add -g openclaw@latest
openclaw onboard --install-daemon

--install-daemon 参数会安装后台守护进程(macOS 用 launchd,Linux 用 systemd),确保 OpenClaw 开机自启、持续在后台运行。

 

方法三:源码安装(推荐开发者)

需要修改源码或参与开发的用户,使用 Git 安装:

 

# 使用官方脚本的 git 模式
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
 
# 或手动克隆
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm openclaw onboard --install-daemon

开发模式启动(支持代码变更自动重载):

 

pnpm gateway:watch

三种安装方式对比

安装方式

适合人群

是否自动装 Node.js

可修改源码

命令复杂度

一键脚本

新手、快速体验

最简单

npm 安装

普通用户

❌ 需自备

简单

源码安装

开发者

❌ 需自备

较复杂

 

安装后:onboard 向导

所有安装方式完成后,都需要运行 onboard 向导完成初始化:

 

openclaw onboard --install-daemon

向导会依次引导完成四项配置:

1. Gateway(网关):设置本地通信网关端口(默认 18789)

2. Workspace(工作区):配置工作目录和权限

3. Channel(通道):连接通信平台(WhatsApp / Telegram / Discord / Slack 等)

4. Skill(技能):从 ClawHub 安装初始技能包

 

安装后常用命令

# 启动网关
openclaw gateway --port 18789 --verbose
 
# 向指定号码发送消息
openclaw message send --to +1234567890 --message "Hello"
 
# 直接与 Agent 交互
openclaw agent --message "帮我整理今天的待办" --thinking high
 
# 更新到最新版
openclaw update --channel stable   # 稳定版
openclaw update --channel beta     # 测试版
openclaw update --channel dev      # 开发版

 

常见问题

Q:安装 OpenClaw 需要付费吗?

OpenClaw 本身完全开源免费(MIT 协议),GitHub 267k+ Stars。运行时需要连接 LLM,使用 Claude 或 GPT 会产生 API 费用;使用本地模型(如 Ollama)则完全免费。Q:Windows 上能正常安装吗?

支持,官方三种安装方式均兼容 Windows。一键脚本会自动处理 Windows 环境差异。建议使用 Windows Terminal 或 PowerShell 运行安装命令。Q:安装后如何验证是否成功?

运行 openclaw --version 查看版本号,或运行 openclaw agent --message "你好" 测试基本交互是否正常。

Q:–install-daemon 是必须的吗?

不是必须,但强烈推荐。守护进程确保 OpenClaw 在后台持续运行,不需要每次手动启动;不安装的话,每次重启设备后需手动运行 openclaw gateway 才能使用。

Q:如何在 ClawHub 上获取更多技能?

访问 clawhub.ai,找到所需技能后按安装指引操作,或在 onboard 向导的 Skill 配置步骤中直接选择安装。

总结

OpenClaw 最推荐的安装方式是一键脚本(新手)或 npm 安装(有 Node.js 环境的用户),配合 --install-daemon 参数安装守护进程,是最完整的安装体验。 安装后 onboard 向导全程引导,从 LLM 连接到技能配置,10 分钟内即可完成所有配置开始使用。

据 OpenClaw 官方 GitHub(github.com/openclaw/openclaw)文档,项目持续活跃更新,升级命令 openclaw update --channel stable 可随时获取最新版本。

本文内容基于 2026 年 3 月 OpenClaw 官方文档(openclaw.ai),建议安装前访问官网确认最新版本要求。

 

延伸资源

 OpenClaw 官网:openclaw.ai

 ClawHub 技能市场:clawhub.ai

 OpenClaw GitHub:github.com/openclaw/openclaw

OpenClaw大模型配置文档