Linux/macOS

核心简介：OpenClaw是一个开源项目，旨在复现和探索“小龙虾AI助手”的功能，其核心特点是集成了 O1推理 和 星野（Hoshino）搜索 能力,处理复杂问题时表现更佳。

---

快速安装步骤

环境准备

• 操作系统：推荐 Linux (Ubuntu 20.04+) 或 macOS，Windows 可通过 WSL2 安装。
• Python：确保已安装 Python 3.10+。
• Conda（推荐）：使用 Conda 管理环境可以避免依赖冲突。
• Git：用于克隆项目代码。
• 网络：能顺畅访问 GitHub 和 Hugging Face。

克隆项目

打开终端,运行：

git clone https://github.com/opendilab/OpenClaw.git
cd OpenClaw

创建并激活虚拟环境

使用 Conda：

conda create -n openclaw python=3.10
conda activate openclaw

或使用 venv：

python -m venv venvsource venv/bin/activate
# Windows
venv\Scripts\activate

安装依赖

项目根目录下的 requirements.txt 或 pyproject.toml 文件包含了主要依赖。

pip install -e .  # 这是最推荐的安装方式，会安装所有核心依赖

如果遇到问题,可以尝试：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118  # 根据你的CUDA版本调整
pip install -r requirements.txt  # 然后安装其余依赖

获取模型权重

OpenClaw 通常不直接包含大模型文件,需要自行下载或配置。

• 本地模型：如果你有 Qwen2.5-32B、DeepSeek-V3 或 Llama-3.1-70B 等支持 O1 推理的模型权重，将其放置在 models/ 目录下。
• API 模式：更简单的方式是配置 推理API（如OpenAI兼容API、Together.ai、Groq等）来调用云端模型。
  • 你需要一个支持 O1 推理的 API 服务。
  • 在项目配置文件（如 .env 或 config.yaml）中设置你的 API Base URL 和 Key。

配置项目

复制示例配置文件并修改：

cp configs/config.example.yaml configs/config.yaml

编辑 configs/config.yaml,关键配置项：

• model_path：指向你的本地模型路径，或设置为 api。
• api_base_url 和 api_key：如果你使用 API 模式,在此填写。
• search_enabled：设置为 true 以启用星野搜索功能（需要配置搜索引擎API，如 Tavily、Serper 或自定义）。

运行测试

启动一个简单的对话或测试脚本,验证安装是否成功：

python examples/quick_start.py

或按照项目 README 中的示例,启动WebUI或命令行交互界面。

---

核心功能快速验证

安装成功后，你可以尝试以下命令或通过WebUI提问,体验其核心优势：

• 复杂推理：“请用中文分步推导一下，如何用微积分计算一个旋转抛物面的面积？”
• 规划任务：“为我制定一个为期一周的北京旅行计划，需要包含历史、文化和美食。”
• 需要搜索的问题：“对比一下2024年特斯拉Model 3和比亚迪汉EV的最新评测信息。”

---

可能遇到的问题（FAQ）

1. CUDA/安装错误：确认你的PyTorch版本与CUDA版本匹配，可去 PyTorch官网 获取安装命令。
2. 模型下载慢：使用 Hugging Face 镜像站或 huggingface-cli 工具。
3. API 配置错误：检查 API 服务商是否支持 O1 推理模型，以及你的 Key 是否有余额和权限。
4. 搜索功能不工作：检查是否已在配置中启用并正确填写了搜索引擎的 API Key。

最快捷的路径是：克隆项目 -> 创建环境 -> 使用 pip install -e . 安装 -> 配置一个可用的 O1 推理 API -> 运行测试。

对于更详细、最新的安装说明和高级配置，请务必查阅项目官方的 README.md 和 docs 目录。

标签： Linux macOS