部署本地 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
复制配置文件模板并进行修改，填入你的 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:
保存文件 (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步：访问并完成初始化方案二：使用 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
官方提供了一个一键安装脚本，会自动完成全局安装 。 - # 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 。
第4步：运行 OpenClaw完成配置后，你可以通过以下命令启动 OpenClaw 的 Gateway 核心服务 ： 总的来说，对于大多数想要本地尝鲜的朋友，我强烈建议使用 Docker 方案，它足够简单且不容易把系统环境弄乱。如果你是个喜欢折腾的开发者，希望深入定制 OpenClaw 的能力，那么 Node.js 源码部署会更适合你。
| 
发表于 