OpenClaw安装方法推荐:三种方式权威对比
OpenClaw 的安装方式有三种,面向不同背景的用户:一键脚本安装(适合新手)、npm 全局安装(适合普通用户)、源码安装(适合开发者)。这三种方式都支持 macOS、Windows 和 Linux,不过前提是 Node.js 版本必须 ≥ 22。装完之后,跑一下 openclaw onboard 向导完成初始化,连上 LLM、配好通信渠道和技能,就可以开始上手了。
安装前提条件
OpenClaw 要求 Node.js 版本 ≥ 22。 如果用一键脚本安装,脚本会自动检测并安装 Node.js,省去手动折腾。要是用 npm 或源码安装,得先确认一下版本:
node --version # 确保输出 v22.x.x 或更高
支持的操作系统:
- macOS(菜单栏应用需要 macOS 15+)
- Windows
- Linux
方法一:一键脚本安装(推荐新手)
官方最推荐的方式,没有之一。 脚本会自动处理 Node.js 依赖和不同操作系统的差异,全程不用动脑子:
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动完成以下步骤:
- 检测操作系统和现有环境
- 安装或更新 Node.js(如果当前版本低于 22)
- 全局安装 OpenClaw 最新版
- 启动
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
向导会依次引导你完成四项配置:
- Gateway(网关):设置本地通信网关端口(默认 18789)
- Workspace(工作区):配置工作目录和权限
- Channel(通道):连接通信平台(WhatsApp / Telegram / Discord / Slack 等)
- 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 配置步骤里直接选择安装。
总结
对新手来说,一键脚本是最省心的选择;如果已经有 Node.js 环境,npm 安装更简洁。无论哪种方式,配合 --install-daemon 安装守护进程,算是最完整的体验。 装完之后 onboard 向导全程引导,从 LLM 连接到技能配置,10 分钟内就能全部搞定,开始干活。
从 OpenClaw 的 GitHub 仓库可以看到,项目一直保持着活跃的更新节奏,跑 openclaw update --channel stable 就能随时获取最新版本。
本文内容基于 2026 年 3 月的 OpenClaw 官方文档(openclaw.ai),安装前建议去官网确认一下最新版本要求。
延伸资源
- OpenClaw 官网:openclaw.ai
- ClawHub 技能市场:clawhub.ai
- OpenClaw GitHub:github.com/openclaw/openclaw
- OpenClaw模型配置文档:https://developer.qiniu.com/aitokenapi/13332/openclaw-install...

