Ubuntu/Debian

环境准备

系统要求

• Linux（推荐 Ubuntu/Debian/CentOS）或 macOS
• 支持 Python 3.7+ 的环境
• 可选：GPU（如需加速）

安装依赖

sudo apt install python3-pip python3-dev build-essential
# CentOS/RHEL
sudo yum groupinstall "Development Tools"
sudo yum install python3-devel

---

安装 OpenClaw

通过 Pip 安装（如果已发布到 PyPI）

pip3 install openclaw  # 如果包名是 "openclaw"
# 或指定版本
pip3 install openclaw==x.x.x

从源码安装（推荐）

1. 克隆仓库：

   

   git clone https://github.com/openclaw-project/openclaw.git
   cd openclaw

2. 安装依赖：

   pip3 install -r requirements.txt

3. 安装 OpenClaw：

   pip3 install -e .  # 开发模式安装
   # 或
   python3 setup.py install

---

验证安装

python3 -c "import openclaw; print(openclaw.__version__)"

或运行测试命令（如果提供）：

openclaw --help  # 检查是否识别命令行工具

---

配置（如果需要）

• 某些工具需要配置 API 密钥或环境变量，请参考项目 README.md 或 docs/ 目录。
• 示例：

  export OPENCLAW_API_KEY="your-key"

---

常见问题解决

Q1：找不到 openclaw 命令

• 确保 ~/.local/bin 或 Python 的 Scripts 目录在 PATH 中：

  export PATH=$PATH:~/.local/bin  # Linux/macOS
  # 或重新登录终端

Q2：依赖冲突

• 使用虚拟环境隔离：

  python3 -m venv venv
  source venv/bin/activate  # Linux/macOS
  # 然后重新安装

Q3：缺少系统库

• OpenCL 驱动（如需 GPU 支持）：

  sudo apt install ocl-icd-opencl-dev  # Ubuntu

---

卸载

pip3 uninstall openclaw
# 清理残留文件
rm -rf ~/.openclaw  # 如果有配置目录

---

附：官方资源

• GitHub 仓库：https://github.com/openclaw-project/openclaw（假设地址,请核实）
• 文档：https://openclaw.readthedocs.io/（如果存在）

---

如果以上步骤无法解决你的问题，请提供更多错误信息或查看项目的 Issue 列表。

标签： Linux发行版 Debian系