AI创想
标题:
安装OpenClaw
[打印本页]
作者:
米落枫
时间:
5 天前
标题:
安装OpenClaw
作者：CSDN博客
文章来源：https://openclaw-doc.cadn.net.cn/install.html
除非有特殊原因，否则请使用安装器。它会设置 CLI 并运行新手引导。
快速安装（推荐）
复制
curl -fsSL https://openclaw.ai/install.sh | bash
复制代码
Windows（PowerShell）：
复制
iwr -useb https://openclaw.ai/install.ps1 | iex
复制代码
下一步（如果你跳过了新手引导）：
复制
openclaw onboard --install-daemon
复制代码
系统要求
Node >=22
macOS、Linux 或通过 WSL2 的 Windowspnpm 仅在从源代码构建时需要
选择安装路径
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
复制代码
如果你看到 sharp: Please add node-gyp to your dependencies，要么安装构建工具（macOS：Xcode CLT + npm install -g node-gyp），要么使用上面的 SHARP_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”警告后，运行 pnpm approve-builds -g 并选择列出的包，然后重新运行安装以执行 postinstall 脚本。然后：
复制
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）其他安装选项
Docker：DockerNix：NixAnsible：AnsibleBun（仅 CLI）：Bun
安装后
运行新手引导：openclaw onboard --install-daemon快速检查：openclaw doctor检查 Gateway 网关健康状态：openclaw status + openclaw health打开仪表板：openclaw dashboard
安装方式：npm vs git（安装器）安装器支持两种方式：
npm（默认）：npm install -g openclaw@latestgit：从 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|npmOPENCLAW_GIT_DIR=...OPENCLAW_GIT_UPDATE=0|1OPENCLAW_NO_PROMPT=1OPENCLAW_DRY_RUN=1OPENCLAW_NO_ONBOARD=1SHARP_IGNORE_GLOBAL_LIBVIPS=0|1（默认：1；避免 sharp 针对系统 libvips 构建）
故障排除：找不到 openclaw（PATH）快速诊断：
复制
node -v
npm -v
npm prefix -g
echo "$PATH"
复制代码
如果 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）
不
在 echo "$PATH" 的输出中，你的 shell 无法找到全局 npm 二进制文件（包括 openclaw）。修复：将其添加到你的 shell 启动文件（zsh：~/.zshrc，bash：~/.bashrc）：
复制
# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"
复制代码
在 Windows 上，将 npm prefix -g 的输出添加到你的 PATH。然后打开新终端（或在 zsh 中执行 rehash / 在 bash 中执行 hash -r）。
更新/卸载
更新：更新迁移到新机器：迁移卸载：卸载
原文地址：https://blog.csdn.net/qq273766764/article/details/158807622
欢迎光临 AI创想 (https://llms-ai.com/)
Powered by Discuz! X3.4