OpenClawSkills
GitHub
参考 • 5 分钟阅读

安装参考

涵盖所有安装方式的全面指南，包括 CLI、Docker 和源码安装。

刚接触 OpenClaw？

如果您需要一个手把手、适合初学者的分步指南，请查看我们的 快速开始教程。而本页面是一个涵盖所有安装方式的全面参考指南。
Tutorial.step

要求

  • Runtime: Node.js ≥22 (npm, pnpm, 或 bun)
  • Platforms: macOS, Linux, Windows (推荐使用 WSL2)
Tutorial.step

推荐安装（上手向导）

首选的设置方案是运行上手向导。它会引导您完成网关、工作区、渠道和技能的设置。CLI 向导是推荐路径，支持 macOS、Linux 和 Windows (WSL2)。

安装命令

Terminal
npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemon

向导会安装网关守护进程（launchd/systemd 用户服务），以便其保持运行。

Tutorial.step

快速开始 (TL;DR)

快速开始命令

Terminal
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
# Send a message
openclaw message send --to +1234567890 --message "Hello from OpenClaw"
# Talk to the assistant
openclaw agent --message "Ship checklist" --thinking high

单行脚本安装

macOS / Linux（系统）

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

适用于 macOS, Windows & Linux。单行脚本会为您安装 Node.js 和其他所有必要组件。

Tutorial.step

从源码安装（开发）

源码构建推荐使用 pnpm。Bun 可选，用于直接运行 TypeScript。

开发环境设置

Terminal
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build  # auto-installs UI deps on first run
pnpm build
pnpm openclaw onboard --install-daemon
# Dev loop (auto-reload on TS changes)
pnpm gateway:watch

注意

使用 pnpm openclaw ... 直接运行 TypeScript 源码（通过 tsx）。pnpm build 会生成 dist/ 目录，用于通过 Node 或打包好的 openclaw 二进制文件运行。
Tutorial.step

Docker 安装

OpenClaw 支持基于 Docker 的安装。您可以在 Docker 容器中运行 OpenClaw 以实现隔离运行。

Docker 安装特别适用于：

  • 在服务器或云实例上运行 OpenClaw
  • 隔离的执行环境
  • 易于部署和扩展
  • Unraid 和其他容器平台

快速 Docker 安装：

Docker Install
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  ghcr.io/openclaw/openclaw:latest

有关详细的 Docker 设置说明、Docker Compose 示例和 Unraid 配置，请参阅 Docker 部署指南。

Tutorial.step

无服务器部署 (OpenClaw Worker)

对于不希望管理硬件或服务器的用户，OpenClaw Worker 允许您在 Cloudflare Workers 上运行 OpenClaw，无需任何物理基础设施。

Moltworker 是以下场景的理想选择：

  • 在没有硬件要求的情况下运行 AI Agent
  • 自动扩展和无服务器架构
  • 按需付费的价格模式
  • 全球边缘加速，低延迟

了解更多关于在 Cloudflare Workers 上部署 OpenClaw 的信息。

Tutorial.step

开发渠道

OpenClaw 提供不同的发布渠道：

  • Stable: 已标记的发布版本（vYYYY.M.D），npm 默认 latest 标签。
  • Beta: 预发布版本标签，npm beta 标签（macOS 应用可能缺失）。
  • Dev: main 分支的最新动态，npm dev 标签（发布时）。

切换渠道：

注意

CLI 命令是 openclaw。请务必使用最新版本以访问所有功能。
Tutorial.step

更新

更新 OpenClaw 到最新版本：

更新命令

Terminal
openclaw update

更新后，运行 openclaw doctor 以检查问题并验证您的配置。