OpenClaw安装教程

除非有特殊原因,否则请使用安装器。它会设置 CLI 并运行新手引导。

快速安装(推荐)

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

Windows(PowerShell):

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

下一步(如果你跳过了新手引导):

openclaw onboard --install-daemon

系统要求

  • 节点 >=22
  • macOS、Linux 或通过 WSL2 的 Windows
  • pnpm仅在从源代码构建时需要

选择安装路径

1)安装器脚本(推荐)

通过 npm 全局安装 并运行新手引导。openclaw

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

安装器标志:

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

详情:安装器内部原理。非交互式(跳过新手引导):

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

2)全局安装(手动)

如果你已经有 Node:

npm install -g openclaw@latest

如果你全局安装了 libvips(macOS 上通过 Homebrew 安装很常见)且安装失败,请强制使用预构建二进制文件:sharp

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果你看到 ,要么安装构建工具(macOS:Xcode CLT + ),要么使用上面的 变通方法来跳过原生构建。sharp: Please add node-gyp to your dependenciesnpm install -g node-gypSHARP_IGNORE_GLOBAL_LIBVIPS=1或使用 pnpm:

pnpm add -g openclaw@latest
pnpm approve-builds -g                # 批准 openclaw、node-llama-cpp、sharp 等
pnpm add -g openclaw@latest           # 重新运行以执行 postinstall 脚本

PNPM 需要显式批准带有构建脚本的包。在首次安装显示“Ignored build scripts”警告后,运行 并选择列出的包,然后重新运行安装以执行 postinstall 脚本。pnpm approve-builds -g然后:

openclaw onboard --install-daemon

3)从源代码(贡献者/开发)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build
openclaw onboard --install-daemon

提示:如果你还没有全局安装,请通过 运行仓库命令。pnpm openclaw ...

4)其他安装选项

安装后

  • 运行新手引导:openclaw onboard --install-daemon
  • 快速检查:openclaw doctor
  • 检查 Gateway 网关健康状态:openclaw status + openclaw health
  • 打开仪表板:openclaw dashboard

安装方式:npm vs git(安装器)

安装器支持两种方式:

  • npm(默认):npm install -g openclaw@latest
  • git:从 GitHub 克隆/构建并从源代码 checkout 运行

CLI 标志

# 显式 npm
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

# 从 GitHub 安装(源代码 checkout)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

常用标志:

  • --install-method npm|git
  • --git-dir <path>(默认:)~/openclaw
  • --no-git-update(使用现有 checkout 时跳过 )git pull
  • --no-prompt(禁用提示;CI/自动化中必需)
  • --dry-run(打印将要执行的操作;不做任何更改)
  • --no-onboard(跳过新手引导)

环境变量

等效的环境变量(对自动化有用):

  • OPENCLAW_INSTALL_METHOD=git|npm
  • OPENCLAW_GIT_DIR=...
  • OPENCLAW_GIT_UPDATE=0|1
  • OPENCLAW_NO_PROMPT=1
  • OPENCLAW_DRY_RUN=1
  • OPENCLAW_NO_ONBOARD=1
  • SHARP_IGNORE_GLOBAL_LIBVIPS=0|1(默认:;避免 针对系统 libvips 构建)1sharp

故障排除:找不到 (PATH)openclaw

快速诊断:

node -v
npm -v
npm prefix -g
echo "$PATH"

如果 (macOS/Linux)或 (Windows)不在 的输出中,你的 shell 无法找到全局 npm 二进制文件(包括 )。$(npm prefix -g)/bin$(npm prefix -g)echo "$PATH"openclaw修复:将其添加到你的 shell 启动文件(zsh:,bash:):~/.zshrc~/.bashrc

# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"

在 Windows 上,将 的输出添加到你的 PATH。npm prefix -g然后打开新终端(或在 zsh 中执行 / 在 bash 中执行 )。rehashhash -r

更新/卸载

原创文章,作者:云东方,如若转载,请注明出处:https://www.yundongfang.com/Yun394.html

赞 (0)
上一篇 2026年3月2日 下午9:18
下一篇 2026年3月2日 下午9:32

相关推荐

  • 飞牛NAS Rockchip 瑞芯微系列 TF 卡刷教程

    系统包下载地址:https://fnnas.com/download-arm 1. 瑞芯微刷机准备工具 Rufus: TF / USB 写卡工具 下载地址:https://gith…

    2026年2月10日
  • 强制重启您的iPhone 18 Pro

    苹果新款iPhone 18 Pro和iPhone 18 Pro Max机型的尺寸与2026年同类机型相同。这些新机型的共同点是全屏设计、动态岛、动作按钮和摄像机控制。 因此,硬重置…

    2026年10月8日
  • Bitvise 更改SSH服务器端口号

    安装SSH服务器后,我们首先建议更改SSH服务器接受连接的端口号。 更改端口号并非绝对必要。我们的许多用户在默认SSH端口22上运行SSH服务器。 我们建议配置SSH服务器使用10…

    2026年10月9日
  • 象象银行Visa白金卡是什么?如何申请使用

    象象银行Visa白金卡是什么? 象象银行Visa白金卡是一张借记卡,允许你直接从银行账户中提取资金,用于购物或提取现金。它提供了一种方便和安全的管理资金的方式,无需携带现金。 象象…

    教程 2026年4月25日
  • 元宝派邀请码激活教程

    公测期间,用户将元宝APP升级至2.56.0或更高版本,进入底部导航栏的「我们」页面,找到「派邀请码」选项并填入有效邀请码,即可解锁创建派的权限。 

    2026年2月7日
  • 象象银行 EleBank怎么开通账号 卡号 账户

    我如何可以开户? 感谢你有兴趣申请我们的银行服务,如要开户,你可以随时通过手机应用商店下载象象银行的手机应用程序,按指示填写数项基本个人资料以方便你日后操作你的户口,很快便可完成开…

    教程 2026年4月23日
  • iPhone 18 Pro 摄像头控制:调整白平衡

    在iPhone 18 Pro和iPhone 18 Pro Max上,苹果在相机应用中的新Pro控件允许你调整相机设置的各个方面,使应用成为一个更加灵活的摄影工具。这里我们解释了如何…

    2026年10月8日
  • iPhone 18 Pro:为60fps视频应用电影效果

    对于iPhone 18 Pro和iPhone 18 Pro Max,苹果扩展了电影模式拍摄时的录制选项。本文解释了什么是电影模式,以及如何启用新的更高4K分辨率设置,以每秒60帧。…

    2026年10月8日
  • Apple 的「快速开始」(Quick Start)是最直接的 iPhone Duo 换机方法

    Apple 的「快速开始」(Quick Start)是最直接的 iPhone Duo 换机方法之一。 只要将新旧 iPhone 放在一起,就能按照画面指示完成设定及资料转移。 使用…

    2026年10月19日
  • 什么是Bitvise 安装Bitvise SSH客户端?

    如果: 你想从Windows电脑连接到远程SSH或SFTP服务器。 你连接的服务器不必运行Bitvise SSH服务器。我们的SSH客户端几乎可以连接到任何SSH或SFTP服务器。…

    2026年10月9日