Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

​
系统要求

  • Node 24（推荐）或 Node 22.14+ — 安装脚本会自动处理
  • macOS、Linux 或 Windows — 原生 Windows 和 WSL2 均受支持；WSL2 更稳定。请参阅 Windows。
  • 仅在你从源码构建时才需要 pnpm

​
推荐：安装脚本

最快的安装方式。它会检测你的操作系统，如有需要会安装 Node，安装 OpenClaw，并启动引导流程。 
curl -fsSL https://openclaw.ai/install.sh | bash
若要安装但不运行引导流程： 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
有关所有标志以及 CI/自动化选项，请参阅 安装程序内部机制。

​
其他安装方式

​
本地前缀安装器（install-cli.sh）

当你希望将 OpenClaw 和 Node 保持在本地前缀下，例如 ~/.openclaw，而不依赖系统级 Node 安装时，请使用此方式： 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
默认支持 npm 安装，并且也支持在相同 前缀流程下进行 git 检出安装。完整参考：安装程序内部机制。 已经安装好了？可通过 openclaw update --channel dev 和 openclaw update --channel stable 在包安装和 git 安装之间切换。请参阅 更新。

​
npm、pnpm 或 bun

如果你已经自行管理 Node： 
npm install -g openclaw@latest
openclaw onboard --install-daemon
如果 sharp 因全局安装的 libvips 而失败：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
从源码

适用于贡献者或任何想要从本地检出版本运行的人： 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
或者跳过链接，直接在仓库内使用 pnpm openclaw ...。请参阅 设置 获取完整的开发工作流。

​
从 GitHub main 安装

npm install -g github:openclaw/openclaw#main

​
容器和包管理器

Docker

容器化或无头部署。

Podman

Docker 的无 root 容器替代方案。

Nix

通过 Nix flake 进行声明式安装。

Ansible

自动化集群配置。

Bun

通过 Bun 运行时仅使用 CLI。

​
验证安装

openclaw --version      # 确认 CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 验证 Gateway 正在运行
如果你希望安装后由系统托管启动：
  • macOS：通过 openclaw onboard --install-daemon 或 openclaw gateway install 创建 LaunchAgent
  • Linux/WSL2：通过相同命令创建 systemd 用户服务
  • 原生 Windows：优先使用计划任务；如果创建任务被拒绝，则回退为每用户的 Startup 文件夹登录项

​
托管与部署

将 OpenClaw 部署到云服务器或 VPS：

VPS

任意 Linux VPS

Docker VM

通用 Docker 步骤

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
更新、迁移或卸载

更新

保持 OpenClaw 为最新版本。

迁移

迁移到新机器。

卸载

完全移除 OpenClaw。

​
故障排查：找不到 openclaw

如果安装成功了，但在终端中找不到 openclaw： 
node -v           # Node 已安装？
npm prefix -g     # 全局包位于哪里？
echo "$PATH"      # 全局 bin 目录是否在 PATH 中？
如果 $(npm prefix -g)/bin 不在你的 $PATH 中，请将其添加到你的 shell 启动文件（~/.zshrc 或 ~/.bashrc）： 
export PATH="$(npm prefix -g)/bin:$PATH"
然后打开一个新的终端。更多详情请参阅 Node 设置。