Openclaw如何本地布局

OpenClaw 的本地部署主要有三种方式，你可以根据自己的技术背景和需求来选择最合适的一种。。另外，无论哪种方式，你都需要提前准备好一个大语言模型（如阿里云百炼、DeepSeek、OpenAI等）的，因为 OpenClaw 本身不提供模型能力。

JQLvopkk

412人浏览 · 2026-03-06 08:20:13

JQLvopkk · 2026-03-06 08:20:13 发布

OpenClaw 的本地部署主要有三种方式，你可以根据自己的技术背景和需求来选择最合适的一种。

在开始前，请先确保你的电脑满足基本要求：CPU双核及以上、内存4GB以上、硬盘20GB可用空间-1 -2。另外，无论哪种方式，你都需要提前准备好一个大语言模型（如阿里云百炼、DeepSeek、OpenAI等）的 API Key，因为 OpenClaw 本身不提供模型能力-2。

下面这张表可以帮助你快速对比和选择：

部署方式	一句话描述	推荐人群	核心步骤
🖥️ 一键脚本安装	最简单，运行脚本全自动安装-2 -3	绝大多数新手用户，希望开箱即用	1. 安装 Node.js 2. 运行一键脚本 3. 跟随向导配置
🐳 Docker 部署	环境隔离，不影响本机，管理方便-1 -2	熟悉 Docker 的用户，或需要在服务器/NAS上运行	1. 安装 Docker 2. 拉取源码和镜像 3. 修改配置并启动
⚙️ 手动全局安装	通过 npm 手动安装，过程更可控-3 -7	熟悉 Node.js/npm 生态，希望对安装有更多控制	1. 安装 Node.js 2. 执行 npm 安装命令 3. 运行向导配置

🖥️ 方案一：一键脚本安装（最简单，新手首选）

这是官方和个人开发者都极力推荐的方式，一个命令就能搞定所有环境配置-2 -3。

准备环境：确保已安装 Node.js 22 或更高版本-2 -7。你可以在终端输入 node -v 查看版本，如果未安装或版本过低，请去 Node.js官网下载安装 LTS 版本-3 -6。
运行安装脚本：
- Windows用户：以管理员身份打开 PowerShell，粘贴并运行以下命令-2：
  
  powershell
  
  复制
  下载
```
irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1 | iex
```
- macOS/Linux用户：打开终端，粘贴并运行以下命令-2：
  
  bash
  
  复制
  下载
```
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash
```
跟随向导完成配置：脚本执行完毕后会自动进入 onboard 初始化向导，按照提示一步步操作即可-3 -6：
- AI 模型配置：选择你的模型供应商（如阿里云百炼、DeepSeek、OpenAI等），并填入准备好的 API Key-2。
- 通信渠道：可以选择配置 Telegram、WhatsApp 等，如果暂时不需要，可以直接跳过，后续在 Web 控制台随时配置-2。
- 安装为后台服务：推荐选择将 OpenClaw 安装为后台守护进程（--install-daemon），这样它就可以一直在后台运行，并且开机自启-2 -3。

🐳 方案二：Docker 部署（环境隔离，管理方便）

Docker 部署可以让你在一个隔离的容器中运行 OpenClaw，非常适合服务器或 NAS 环境-2。

准备环境：确保已安装 Docker 和 Docker Compose（20.10.0+）-1。

拉取源码和镜像：打开终端，依次执行以下命令-1：

bash

复制

下载

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

# 2. 拉取汉化版源码（如果不需要汉化，可以去GitHub拉取官方版）
git clone https://github.com/openclaw-community/openclaw-zh.git .

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

修改配置文件：

bash

复制
下载
```
# 复制示例配置文件
cp config/example.yaml config/config.yaml
# 编辑配置文件（可以使用nano、vim等编辑器）
nano config/config.yaml
```
在 config.yaml 文件中，至少需要修改以下关键项-1：
- 模型配置：在 models.providers.bailian 下（或其他你使用的供应商下），填入你的 apiKey。
- 服务端口：确认 server.port 为 18789（或其他未被占用的端口）。
- 数据存储：可以自定义 storage.local.path 来指定数据在本机的保存路径。
启动服务：在 /opt/openclaw 目录下运行以下命令启动容器-1：

bash

复制
下载
```
docker compose up -d
```
启动后，可以使用 docker compose ps 查看容器状态，或用 docker compose logs -f 查看实时日志。

⚙️ 方案三：手动全局安装（过程可控）

如果你熟悉 npm，或者想体验最原汁原味的安装过程，可以选择这种方式-3 -7。

准备环境：同样需要安装 Node.js 22 或更高版本-7。国内用户建议先配置 npm 国内镜像源，加速下载-6：

bash

复制
下载
```
npm config set registry https://registry.npmmirror.com
```
执行 npm 安装：
- 安装官方原版-6：npm install -g openclaw
- 安装中文社区版（推荐，更适配国内网络和环境）-7：npm install -g openclaw-cn@latest
运行初始化向导：安装完成后，同样需要运行 onboard 向导来完成 AI 模型和渠道等基础配置-3 -7：

bash

复制
下载
```
openclaw-cn onboard --install-daemon
```