方法一，使用 venv Python内置)

openclaw 中文openclaw 2026-04-09 2

第一部分：安装前准备

确认系统要求

操作系统： Windows 10/11， macOS 10.15+，或 Linux（Ubuntu 20.04+/CentOS 8+ 推荐）
Python： 版本 3.8 至 3.11（这是大多数AI项目的黄金版本范围，请尽量避免使用3.12+，除非项目明确支持）
包管理工具： pip（最新版）
版本控制： git（用于从GitHub克隆代码）
可选但推荐：
- Conda 或 Miniconda：用于创建独立的Python环境，强烈推荐。
- CUDA 和 cuDNN：如果你有NVIDIA GPU并希望进行本地模型推理加速，需要安装对应版本的CUDA工具包。

安装基础依赖

Windows：
1. 安装 Python，务必勾选 “Add Python to PATH”。
2. 安装 Git for Windows。

macOS：

# 使用Homebrew安装（如果未安装Homebrew，请先访问 https://brew.sh）
brew install git python

Linux (Ubuntu/Debian)：

sudo apt update
sudo apt install git python3 python3-pip python3-venv

（强烈推荐）创建虚拟环境

使用虚拟环境可以避免包版本冲突。

方法一，使用 venv Python内置)-第1张图片-OpenClaw下载中文-AI中文智能体

# 激活环境
# Windows:
openclaw_env\Scripts\activate
# macOS/Linux:
source openclaw_env/bin/activate
# 方法二：使用 Conda
conda create -n openclaw_env python=3.10
conda activate openclaw_env

激活后,命令行提示符前会出现 (openclaw_env) 标识。

第二部分：安装 OpenClaw

假设 OpenClaw 的代码托管在 GitHub 上。

克隆代码仓库

在你的工作目录下打开终端（并确保虚拟环境已激活），执行：

git clone https://github.com/opendilab/OpenClaw.git  # 请替换为实际的仓库URL
cd OpenClaw

注意：实际的GitHub仓库地址可能需要搜索确认，这里以假设的地址为例。

使用 pip 安装（推荐方式）

如果项目提供了 setup.py 或 pyproject.toml，最佳方式是使用 pip 进行“可编辑”安装，这会将包链接到源代码，便于开发。

# 方式A：标准安装（如果项目结构简单）
pip install -r requirements.txt  # 先安装核心依赖
pip install -e .  # 安装OpenClaw包本身
# 方式B：一步安装（如果项目配置完善）
pip install -e .[all]  # 安装所有额外依赖，如“dev”, “test”, “web”等

关键参数 -e 代表“可编辑模式”，你对源代码的修改会立即生效。

安装浏览器驱动（如果涉及网页自动化）

OpenClaw 需要控制浏览器（例如通过 Selenium）：

安装浏览器：确保已安装 Google Chrome 或 Microsoft Edge。
下载驱动：访问 ChromeDriver官网或 EdgeDriver官网，下载与你的浏览器主版本号完全一致的驱动程序。
放置驱动：
- Windows：将下载的 chromedriver.exe 放在项目根目录，或将其所在目录添加到系统 PATH 环境变量中。
- macOS/Linux：将 chromedriver 移动到 /usr/local/bin 目录下（可能需要 sudo 权限）。
```
sudo mv ~/Downloads/chromedriver /usr/local/bin/
```
验证驱动：
```
chromedriver --version
```
应显示版本号。

第三部分：配置与验证

获取并配置 API Keys

OpenClaw 通常需要连接大模型API（如 OpenAI, DeepSeek, 文心一言等）。

在项目根目录找到配置文件模板,通常是 config.yaml.example, .env.example 或 config_template.py。
复制一份并重命名（去掉 .example）。
```
cp .env.example .env
```

用文本编辑器打开配置文件,填入你的API Key。

# 示例 .env 文件内容
OPENAI_API_KEY="sk-your-openai-api-key-here"
OPENAI_BASE_URL="https://api.openai.com/v1" # 如果使用代理或第三方兼容接口
MODEL="gpt-4o-mini" # 指定使用的模型

重要：切勿将包含真实API Key的配置文件上传到Git等公开版本控制系统！

运行测试/示例脚本

项目通常会提供示例来验证安装是否成功。

# 查看项目根目录的 README.md 或 examples/ 文件夹
python examples/quick_start.py
# 或运行一个简单的测试
python -m pytest tests/test_basic.py -v

如果看到程序开始与AI交互或成功通过测试,说明安装基本成功。

第四部分：常见问题与故障排除

pip install 失败，提示找不到版本或编译错误：
- 升级pip和工具： pip install --upgrade pip setuptools wheel
- 使用国内镜像源（中国用户）：
```
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```
- 具体错误：如果是某个特定包（如 chromadb, faiss）编译失败，请根据错误信息搜索，可能需要安装系统级开发库。
  - Ubuntu： sudo apt install build-essential python3-dev
  - macOS： xcode-select --install
运行时提示 ModuleNotFoundError: No module named ‘...’：
- 检查虚拟环境是否已激活。
- 可能缺少某些可选依赖,查看 requirements.txt 或 setup.py 中的 extras_require 部分，用 pip install -e .[web] 等形式安装。
浏览器自动化失败：
- 确认浏览器驱动版本与浏览器版本完全匹配。
- 确认驱动文件路径已加入 PATH，或在代码中指定了驱动路径。
- 关闭所有已打开的浏览器实例再运行程序。
API调用失败/网络错误：
- 检查 .env 文件中的API Key和Base URL是否正确。
- 检查网络连接,特别是如果需要科学上网。
- 查看模型的可用性和余额。