OpenClaw 部署指南：一行命令到完整的多渠道 AI 助手

本文将详细介绍如何在你的机器或 VPS 上部署 OpenClaw，从最快的一键安装脚本到 Docker 容器化部署，覆盖 macOS、Linux 和 Windows（WSL2）三大平台，并完成第一次成功对话。

部署前提条件

系统要求

条件	说明
Node.js	≥ 22.16（推荐 Node 24）
操作系统	macOS / Linux / Windows（推荐 WSL2）
网络	能访问 AI 服务商 API（OpenAI/Claude 等）及目标消息平台
内存	至少 512 MB 可用 RAM

Windows 用户注意： 强烈推荐在 WSL2 中运行 OpenClaw，原生 Windows 支持有一定限制。

准备一个 AI 模型 API Key

OpenClaw 本身不提供 AI 模型，你需要至少准备一个 API Key：

• OpenAI：从 https://platform.openai.com/api-keys 创建
• Anthropic（Claude）：从 https://console.anthropic.com/ 获取
• 或其他支持的模型提供商

---

方法一：一键安装脚本（推荐新手）

这是最简单的方式，脚本会自动检测、安装 Node.js 并完成初始化引导。

macOS / Linux / WSL2：

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

Windows（PowerShell）：

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

脚本执行完毕后会自动启动交互式 onboarding 引导程序，按提示填写 API Key 和选择渠道即可。

如果只想安装二进制、不走引导

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

# Windows PowerShell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

---

方法二：npm / pnpm 手动安装

如果你已经有 Node.js 环境，可以直接用包管理器安装：

使用 npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

macOS 上遇到 sharp 构建错误？ 尝试：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

使用 pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g   # 批准含 build script 的包（首次必须执行）
openclaw onboard --install-daemon

openclaw onboard 做了什么？

--install-daemon 参数会把 Gateway 注册为后台系统服务：

• macOS：注册为 launchd 用户服务（自动随登录启动）
• Linux：注册为 systemd 用户服务
• Windows：创建计划任务

这样 Gateway 无需每次手动启动，后台持续运行。

---

方法三：Docker 容器部署（推荐服务器场景）

Docker 方式适合部署在无桌面的 Linux VPS 上，完全隔离，易于更新。

前提

确保已安装 Docker 和 Docker Compose。

快速启动

# 克隆仓库（或只下载 docker-compose.yml）
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 复制环境变量模板
cp .env.example .env
# 编辑 .env 填入你的 API Key
nano .env

# 启动服务
docker compose up -d

.env 文件关键变量：

# AI 模型配置（至少填一个）
OPENAI_API_KEY=sk-your-openai-key-here

# Gateway 设置
OPENCLAW_STATE_DIR=/data/openclaw   # 数据持久化目录

查看 Gateway 日志

docker compose logs -f openclaw

使用 Docker 后更新 OpenClaw

docker compose pull
docker compose up -d

---

方法四：从源码构建（开发者）

适合想参与贡献或调试的开发者：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖（必须用 pnpm）
pnpm install

# 构建 Web UI（首次必须）
pnpm ui:build

# 构建项目
pnpm build

# 全局链接 CLI
pnpm link --global

# 执行引导
openclaw onboard --install-daemon

开发时使用热重载模式：

pnpm gateway:watch  # 修改源码后自动重载

---

启动与基础验证

安装完成后，用以下命令验证 Gateway 是否正常运行：

# 检查配置和连接状态
openclaw doctor

# 查看 Gateway 状态
openclaw status

# 打开 Web 控制台（在浏览器中查看仪表盘）
openclaw dashboard

openclaw doctor 输出示例：

✅ Node.js 24.0.0 — OK
✅ Gateway service installed — OK
✅ Gateway running at ws://127.0.0.1:18789 — OK
✅ OpenAI API key — OK
⚠️  No channel connected — Add a channel to start chatting

---

连接第一个消息渠道（以 Telegram 为例）

步骤 1：创建 Telegram Bot

1. 打开 Telegram，搜索并与 @BotFather 对话
2. 发送 /newbot，按提示输入 Bot 名称
3. 获得 Bot Token，格式如：1234567890:AABBccDD...

步骤 2：配置 OpenClaw

编辑配置文件（通常在 ~/.openclaw/config.json）：

{
  "channels": {
    "telegram": {
      "token": "1234567890:AABBccDD...",
      "dmPolicy": "pairing"
    }
  }
}

或通过 openclaw onboard 引导程序交互式配置。

步骤 3：重启 Gateway

openclaw gateway restart

步骤 4：发消息测试

在 Telegram 中找到你的 Bot，发送第一条消息。首次消息会收到配对码提示，用 CLI 审批：

openclaw pairing approve telegram <收到的配对码>

审批后即可正常对话！

---

常见问题

openclaw: command not found

全局 npm 包路径没在 $PATH 里。执行：

export PATH="$(npm prefix -g)/bin:$PATH"
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc

Gateway 端口 18789 被占用

# 查看占用端口的进程
lsof -i :18789

# 或在配置文件中改端口
# ~/.openclaw/config.json
{
  "gateway": { "port": 18790 }
}

版本升级

# 稳定版
openclaw update --channel stable

# 最新预发布版
openclaw update --channel beta

---

部署方式对比速查

方式	适合人群	难度	守护进程
一键脚本	完全新手	⭐	✅ 自动
npm 安装	有 Node 基础	⭐⭐	✅ onboard
Docker	VPS / 服务器	⭐⭐⭐	✅ compose
源码构建	开发者	⭐⭐⭐⭐	手动

---

参考资料：

• 安装文档: https://docs.openclaw.ai/start/getting-started
• Docker 部署: https://docs.openclaw.ai/install/docker
• 渠道配置: https://docs.openclaw.ai/channels