环境要求
- 操作系统:Linux(推荐 Ubuntu 18.04+)或 macOS(部分功能可能受限)
- Python:3.8 或更高版本
- PyTorch:1.9+(需与CUDA版本匹配)
- CUDA(可选):11.3+(如使用GPU)
安装步骤
1 克隆仓库
git clone https://github.com/openclaw-project/openclaw.git cd openclaw
2 创建虚拟环境(推荐)
python -m venv openclaw_env source openclaw_env/bin/activate # Linux/macOS``` #### **2.3 安装依赖** ```bash pip install --upgrade pip pip install -r requirements.txt
4 安装 PyTorch(如未自动安装)
根据CUDA版本选择(参考 pytorch.org):

# 示例:CUDA 11.3 pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu113
5 安装 OpenClaw 核心包
pip install -e . # 开发模式安装
快速验证
运行示例测试:
python examples/quick_demo.py
或启动基础交互界面:
python scripts/launch_webui.py # 如有WebUI
配置模型(可选)
- 下载预训练模型至
models/目录 - 配置API密钥(如使用外部服务):
echo "OPENAI_API_KEY=your_key" >> .env
常见问题
- CUDA版本不匹配:根据PyTorch官网命令重新安装。
- 依赖冲突:使用虚拟环境隔离,或尝试
pip install --force-reinstall。 - 内存不足:减小模型批次大小(修改配置中的
batch_size)。
进阶操作
- 训练自定义模型:参考
docs/training.md - API部署:运行
python api/server.py - Docker支持:执行
docker build -t openclaw .
附:一键脚本(Ubuntu)
wget -O install_openclaw.sh https://raw.githubusercontent.com/openclaw-project/openclaw/main/scripts/install.sh chmod +x install_openclaw.sh ./install_openclaw.sh
注意:详细文档请查看 docs/ 目录,或访问 OpenClaw Wiki。
如有问题,请提交 Issue 并提供错误日志。
版权声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。