克隆仓库

我来为您提供一份详细的 AI 小龙虾（OpenClaw）源码编译安装指南，OpenClaw 是一个基于深度学习的机器人控制项目，以下是完整的安装步骤：

系统要求

基础环境

• 操作系统: Ubuntu 20.04/22.04（推荐）或 Windows WSL2
• Python: 3.8-3.10
• CUDA: 11.3-11.8（如有 NVIDIA GPU）
• 内存: 至少 8GB
• 存储: 至少 20GB 可用空间

安装步骤

获取源码

cd OpenClaw
# 或使用特定版本
git clone --branch v1.0.0 https://github.com/OpenClaw/OpenClaw.git

安装系统依赖

Ubuntu/Debian:

sudo apt update
sudo apt install -y \
    build-essential \
    cmake \
    git \
    wget \
    curl \
    libopencv-dev \
    libeigen3-dev \
    libboost-all-dev \
    python3-dev \
    python3-pip \
    python3-venv

创建 Python 虚拟环境

python3 -m venv openclaw_env
source openclaw_env/bin/activate
# Windows (CMD/PowerShell)
# openclaw_env\Scripts\activate

安装 Python 依赖

# 升级 pip
pip install --upgrade pip
# 安装核心依赖
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118  # CUDA 11.8
# 或 CPU 版本
# pip install torch torchvision torchaudio
# 安装项目依赖
pip install -r requirements.txt

编译 C++/CUDA 扩展（如有）

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

安装 ROS 依赖（如需机器人控制）

# 安装 ROS2 Humble（Ubuntu 22.04）
sudo apt install software-properties-common
sudo add-apt-repository universe
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
sudo apt update
sudo apt install ros-humble-desktop

配置环境变量

# 添加到 ~/.bashrc 或 ~/.zshrc
export OPENCLAW_ROOT=/path/to/OpenClaw
export PYTHONPATH=$OPENCLAW_ROOT:$PYTHONPATH
export LD_LIBRARY_PATH=$OPENCLAW_ROOT/build/lib:$LD_LIBRARY_PATH
# 激活配置
source ~/.bashrc

下载预训练模型

# 使用提供的脚本
python scripts/download_models.py
# 或手动下载
mkdir -p checkpoints
wget https://github.com/OpenClaw/models/releases/download/v1.0/openclaw_base.pth -O checkpoints/

验证安装

# 运行测试
python -m pytest tests/ -v
# 运行示例
python examples/simple_demo.py
# 检查导入
python -c "import openclaw; print('OpenClaw version:', openclaw.__version__)"

Docker 安装（替代方案）

# Dockerfile
FROM nvidia/cuda:11.8.0-cudnn8-runtime-ubuntu22.04
RUN apt update && apt install -y \
    python3.10 \
    python3-pip \
    git \
    libopencv-dev
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
CMD ["python", "main.py"]

构建并运行：

docker build -t openclaw .
docker run --gpus all -it openclaw

常见问题解决

CUDA 版本不匹配

# 查看 CUDA 版本
nvcc --version
# 安装匹配的 PyTorch
pip install torch==2.0.1+cu117 torchvision==0.15.2+cu117 torchaudio==2.0.2 \
  --index-url https://download.pytorch.org/whl/cu117

缺少依赖库

# 安装缺失的库
sudo apt install libgl1-mesa-glx libglib2.0-0

内存不足

# 设置交换空间
sudo fallocate -l 8G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Python 包冲突

# 创建干净的虚拟环境
conda create -n openclaw python=3.9
conda activate openclaw

开发模式安装

# 可编辑模式安装
pip install -e .
# 安装开发依赖
pip install -r requirements-dev.txt
# 安装预提交钩子
pre-commit install

平台特定说明

Windows

1. 使用 WSL2 或 MinGW
2. 安装 Visual Studio Build Tools
3. 可能需要手动编译某些依赖

macOS

# 使用 Homebrew 安装依赖
brew install cmake opencv eigen boost

验证安装成功

运行完整测试套件：

# 单元测试
python -m pytest tests/unit/
# 集成测试
python -m pytest tests/integration/
# 功能测试
python -m pytest tests/functional/

获取帮助

• 官方文档: docs/ 目录
• 问题追踪: GitHub Issues
• 社区支持: Discord/Slack 频道
• 邮件列表: 官方邮件列表

更新与卸载

# 更新代码
git pull origin main
pip install -r requirements.txt --upgrade
# 卸载
pip uninstall openclaw
rm -rf openclaw_env/

这个指南涵盖了大多数安装场景,如果遇到具体问题，请查看项目根目录的 README.md 或 INSTALL.md 获取最新信息。