OpenCLaw跨平台安装部署教程：Linux/Windows/macOS详细步骤

OpenCLaw 是一个开源的多智能体协作框架，支持在 Linux、Windows 和 macOS 上运行。本文将从零开始，带你逐步完成三个主流操作系统的安装与配置。所有命令均以代码块形式给出，关键步骤配有示意图占位，确保你能够顺利搭建开发环境。

一、准备工作

在正式开始安装之前，需要准备以下基础环境：

1. <strong>Git</strong>：用于克隆 OpenCLaw 仓库。
2. <strong>Python 3.8+</strong>：OpenCLaw 的核心依赖。
3. <strong>C++ 编译器</strong>（Linux/macOS 需要 GCC/Clang，Windows 需安装 Visual Studio Build Tools）。
4. <strong>CMake 3.15+</strong>：部分模块需要编译。

1.1 检查现有环境

打开终端（Windows 下使用 PowerShell 或 CMD），依次执行以下命令：

git --version
python --version
cmake --version

如果缺少某工具，请根据操作系统自行安装。下方安装步骤中会包含缺失依赖的安装命令。

1.2 获取 OpenCLaw 源码

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

切换到 stable 分支（推荐）：

git checkout stable

—

二、在 Linux 上安装 OpenCLaw

Linux 发行版（Ubuntu 20.04+ / CentOS 8+）安装流程较为统一。以下以 Ubuntu 为例。

2.1 安装系统依赖

sudo apt update
sudo apt install -y build-essential cmake libssl-dev libcurl4-openssl-dev

2.2 创建 Python 虚拟环境

python3 -m venv openclaw_env
source openclaw_env/bin/activate

2.3 安装 Python 依赖

pip install --upgrade pip
pip install -r requirements.txt

2.4 编译 C++ 组件

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)
sudo make install

2.5 配置环境变量

将以下内容添加到 <code>~/.bashrc</code> 或 <code>~/.zshrc</code> 中：

export OPENCLAW_HOME=/usr/local/openclaw
export PATH=$PATH:$OPENCLAW_HOME/bin

然后执行 <code>source ~/.bashrc</code> 使其生效。

—

三、在 Windows 上安装 OpenCLaw

Windows 安装需要额外注意编译环境的配置。推荐使用 PowerShell（管理员模式）。

3.1 安装必备工具

– <strong>Git for Windows</strong>：从 [git-scm.com](https://git-scm.com) 下载安装。
– <strong>Visual Studio Build Tools 2022</strong>：安装时勾选「C++ 生成工具」和「Windows 10 SDK」。
– <strong>CMake</strong>：从 [cmake.org](https://cmake.org) 下载安装，安装时勾选“Add CMake to system PATH”。
– <strong>Python 3.9+</strong>：从 [python.org](https://python.org) 下载安装，务必勾选“Add Python to PATH”。

3.2 使用 PowerShell 安装依赖

# 打开 PowerShell（管理员）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
python -m venv openclaw_env
.openclaw_envScriptsActivate.ps1

3.3 安装 Python 包

pip install --upgrade pip
pip install -r requirements.txt

3.4 编译 C++ 组件

在 PowerShell 中运行 Visual Studio 的开发者命令提示符环境：

# 假设 VS Build Tools 默认安装路径
& "C:Program Files (x86)Microsoft Visual Studio2022BuildToolsCommon7ToolsLaunch-VsDevShell.ps1"

然后进入项目目录执行编译：

cd openclaw
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

编译成功后，将 <code>buildRelease</code> 目录添加到系统 PATH 中（通过系统环境变量设置）。

—

四、在 macOS 上安装 OpenCLaw

macOS 安装需要提前安装 Homebrew 包管理器。

4.1 安装 Homebrew 及基础工具

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install cmake git

4.2 安装 C++ 编译器

macOS 自带 Clang，无需额外安装。如果遇到编译错误，可安装 Xcode Command Line Tools：

xcode-select --install

4.3 创建 Python 虚拟环境并安装依赖

python3 -m venv openclaw_env
source openclaw_env/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

4.4 编译与安装

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(sysctl -n hw.ncpu)
sudo make install

4.5 环境变量配置

在 <code>~/.zshrc</code> 中添加：

export OPENCLAW_HOME=/usr/local/openclaw
export PATH=$PATH:$OPENCLAW_HOME/bin

执行 <code>source ~/.zshrc</code> 生效。

—

五、验证安装与基本使用

安装完成后，可通过以下命令验证 OpenCLaw 是否正常工作：

openclaw --version

如果显示版本号，说明安装成功。接下来可以运行官方示例：

cd examples/hello_world
openclaw run config.yaml

你应该会看到类似 <code>Hello from agent-1</code> 的输出。

常见问题排查

– <strong>找不到 openclaw 命令</strong>：检查 PATH 是否包含安装路径，或重新加载环境变量。
– <strong>编译错误</strong>：确保 CMake 和编译器版本满足最低要求，并安装了所有系统依赖。
– <strong>Python 错误</strong>：确认虚拟环境已激活，且 <code>requirements.txt</code> 中的包已全部安装。

如果遇到其他问题，请查阅官方文档或提交 GitHub Issue。