03-OpenClaw 环境搭建与配置完全指南

OpenClaw 环境搭建与配置完全指南

在前两篇博客中，我们介绍了 OpenClaw 的核心理念和基础概念。现在，让我们进入实践环节——本文将详细讲解如何搭建和配置 OpenClaw 运行环境。无论你是在本地开发、服务器部署，还是使用容器化方案，这篇指南都将帮助你快速完成环境准备。

1. 安装指南：多种部署方式

OpenClaw 提供了多种灵活的安装方式，适应不同用户的使用场景。根据你的需求选择最适合的方案。

1.1 Docker 安装（推荐）

Docker 是 OpenClaw 推荐的部署方式，具有环境隔离、易于管理和版本控制的优势。

前置要求

• Docker 20.10 或更高版本
• Docker Compose 2.0 或更高版本（可选，用于编排）

安装步骤

方式一：使用官方 Docker 镜像

# 拉取最新镜像dockerpull openclaw/openclaw:latest# 创建本地配置目录mkdir-p~/.openclaw# 运行容器dockerrun-d\--nameopenclaw\-p19001:19001\-v~/.openclaw:/root/.openclaw\-v/var/run/docker.sock:/var/run/docker.sock\openclaw/openclaw:latest

方式二：使用 Docker Compose

创建docker-compose.yml文件：

version:'3.8'services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclawrestart:unless-stoppedports:-"19001:19001"volumes:-~/.openclaw:/root/.openclaw-/var/run/docker.sock:/var/run/docker.sock-./workspace:/root/.openclaw/workspaceenvironment:-OPENCLAW_LOG_LEVEL=info-OPENCLAW_GATEWAY_PORT=19001networks:-openclaw-netnetworks:openclaw-net:driver:bridge

启动服务：

docker-composeup-d

Docker 安装的优势

1.2 npm/pnpm 安装

如果你希望在本地直接运行 OpenClaw CLI，可以使用 npm 或 pnpm 安装。

前置要求

• Node.js 18.x 或更高版本
• npm 9.x 或 pnpm 8.x

使用 npm 安装

# 全局安装npminstall-gopenclaw# 验证安装openclaw--version

使用 pnpm 安装（推荐）

pnpm 具有更快的安装速度和更优的磁盘空间利用：

# 全局安装pnpminstall-gopenclaw# 或者使用 pnpm 执行无需安装pnpmdlx openclaw@latest--help

配置环境变量

将 OpenClaw 的二进制目录添加到 PATH：

# 添加到 ~/.bashrc 或 ~/.zshrcexportPATH="$HOME/.local/share/pnpm:$PATH"# 立即生效source~/.bashrc

1.3 源码编译安装

如果你需要深度定制或参与 OpenClaw 开发，可以从源码编译安装。

前置要求

• Git
• Node.js 18.x+
• pnpm 8.x+
• Rust 工具链（用于编译原生模块，可选）

编译步骤

# 1. 克隆仓库gitclone https://github.com/openclaw/openclaw.gitcdopenclaw# 2. 安装依赖pnpminstall# 3. 编译项目pnpmbuild# 4. 链接到全局（开发模式）pnpmlink--global# 5. 验证openclaw--version

开发模式运行

# 启动开发服务器pnpmdev# 运行测试pnpmtest# 构建发行版pnpmpackage

1.4 平台支持说明

OpenClaw 支持多种操作系统和架构：

最低系统要求：

• 内存：2GB RAM（推荐 4GB+）
• 磁盘：500MB 可用空间
• 网络：能够访问模型 API 端点

2. 配置文件详解：profiles.yaml

OpenClaw 使用profiles.yaml（或openclaw.json）作为核心配置文件，管理所有运行时参数。

2.1 配置文件位置

# 查看当前配置文件路径openclaw configfile# 默认位置~/.openclaw/openclaw.json

2.2 完整配置示例

以下是一个完整的生产环境配置示例：

# profiles.yaml 完整配置示例meta:lastTouchedVersion:"2026.3.11"lastTouchedAt:"2026-03-21T16:08:53.003Z"# 向导配置wizard:lastRunAt:"2026-03-21T16:04:42.707Z"lastRunVersion:"2026.3.11"lastRunCommand:"onboard"lastRunMode:"local"# 智能体默认配置agents:defaults:workspace:"/root/.openclaw/workspace"compaction:mode:"safeguard"# 上下文压缩模式model:primary:"tencentcodingplan/tc-code-latest"reasoning:true# 启用推理能力# 工具配置tools:profile:"full"# 工具集配置：minimal/standard/fulldeny:# 禁用特定工具-"browser"-