怎么本地部署 OpenClaw ?

管理员 12 小时前

智能体

部署本地 OpenClaw 主要有两种主流且资料详尽的方式，你可以根据自己的技术背景和需求来选择。

我把这两种方式的流程整理成了一个概览表格，方便你快速对比和决策：

特性	方案一：Docker 部署（推荐新手）	方案二：Node.js 源码部署（适合开发者）
核心依赖	Docker, Docker Compose, Git	Node.js (≥22), npm, Git
优点	环境隔离，部署和卸载干净，失败率低，适合快速体验	配置灵活，方便二次开发和调试，可直接运行最新源码
缺点	需要了解基本的 Docker 命令	对系统环境要求较高，可能遇到依赖冲突
适用人群	希望快速、稳定运行OpenClaw的用户	开发者、希望修改源码或深度定制OpenClaw的用户

方案一：使用 Docker 部署（推荐）

这种方法将 OpenClaw 运行在容器中，与你的系统环境隔离，最为稳妥。

第1步：准备工作与环境检查

在开始之前，请确保你的电脑满足最低要求：CPU ≥ 2核，内存 ≥ 4GB，磁盘空间 ≥ 20GB 。

第2步：安装通用依赖

你需要安装 Docker、Git 等工具。以下是 Linux (Ubuntu/Debian) 的示例命令，Windows 用户请手动下载安装 Docker Desktop 和 Git 。

# 1. 安装 Docker (使用阿里云镜像加速)
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 2. 启动 Docker 并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 3. 验证 Docker 安装
docker --version && docker compose version

# 4. 安装 Git
sudo apt update && sudo apt install git -y
git --version

第3步：获取 OpenClaw 源码与镜像

创建工作目录，并拉取汉化版的源码和预构建的 Docker 镜像。

# 1. 创建并进入部署目录
mkdir -p /opt/openclaw && cd /opt/openclaw

# 2. 拉取2026版OpenClaw源码（汉化版）
git clone https://github.com/openclaw-community/openclaw-zh.git .

# 3. 拉取OpenClaw核心镜像（国内加速源）
docker pull registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw-core:2026-zh
docker pull registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw-web:2026-zh

# 4. 验证镜像拉取结果
docker images | grep openclaw

第4步：初始化配置文件

复制配置文件模板并进行修改，填入你的 API Key 等重要信息。

# 1. 复制默认配置文件
cp config/example.yaml config/config.yaml

# 2. 编辑配置文件 (这里使用nano，你也可以用vim)
nano config/config.yaml

找到文件中的对应部分，修改为以下内容。请务必将 你的阿里云百炼API-Key 替换为你自己的密钥 。

# ① 模型配置（替换为你的API-Key）
models:
  providers:
    bailian:
      apiKey: "你的阿里云百炼API-Key"   # <-- 在这里填入你的Key
      model: "bailian/qwen3-max-2026-01-23"

# ② 服务端口配置
server:
  port: 18789
  host: "0.0.0.0"          # 监听所有网络接口，方便局域网内访问

# ③ 数据存储配置（本地路径）
storage:
  local:
    path: "/opt/openclaw/data"

保存文件 (nano 中按 Ctrl+X，然后按 Y 确认，再按 Enter)。

第5步：启动 OpenClaw 服务

使用 Docker Compose 启动服务，并检查运行状态。

# 1. 启动服务（后台运行）
docker compose up -d

# 2. 查看服务启动状态（所有容器应为 "Up" 状态）
docker compose ps

# 3. （可选）查看启动日志，确保无错误
docker compose logs -f

第6步：访问并完成初始化

打开浏览器，访问 http://127.0.0.1:18789 (如果在本机) 或 http://你的局域网IP:18789。首次访问时，页面会引导你设置管理员密码，之后就可以开始使用你的 OpenClaw 了。

方案二：使用 Node.js 从源码部署

这种方式更贴近开发环境，适合需要定制功能的用户。

第1步：安装 Node.js 环境

OpenClaw 需要 Node.js 22 或更高版本 。推荐使用 NodeSource 仓库进行安装。

# 1. 添加 NodeSource 仓库 (以 Node.js 22 为例)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 2. 安装 Node.js
sudo apt install -y nodejs

# 3. 验证安装
node -v   # 应显示 v22.x.x 或更高
npm -v

# 4. (可选) 配置 npm 国内镜像加速
npm config set registry https://registry.npmmirror.com

第2步：安装 OpenClaw

官方提供了一个一键安装脚本，会自动完成全局安装。

# macOS / Linux 系统执行
curl -fsSL https://openclaw.ai/install.sh | bash

安装脚本执行完成后，会自动进入一个名为 onboard 的交互式设置向导。如果向导中断，你可以随时通过 openclaw onboard --install-daemon 命令重新启动。

第3步：处理可能遇到的问题

command not found 错误: 安装后如果找不到 openclaw 命令，通常是因为 npm 的全局安装目录不在系统的 PATH 环境变量中。你可以通过 npm prefix -g 找到该目录（例如 /usr/local），然后将 export PATH="$(npm prefix -g)/bin:$PATH" 添加到你的 ~/.bashrc 或 ~/.zshrc 文件中，并执行 source ~/.bashrc 使其生效。
sharp 模块安装失败: 在某些系统上，可能会遇到图像处理库 sharp 的安装错误。可以尝试设置环境变量绕过本地编译：SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest 。