使用Homebrew

环境准备

系统要求

• 操作系统：Linux/macOS/Windows (WSL2推荐)
• Python版本：3.8+
• CUDA：11.3+ (GPU加速可选)

基础依赖安装

Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip git wget curl

macOS:

Windows (WSL2):

# 在WSL2 Ubuntu中运行
sudo apt update
sudo apt install python3 python3-pip

OpenClaw 安装方式

方式1：使用pip直接安装（推荐）

# 最新稳定版
pip install openclaw
# 或指定版本
pip install openclaw==1.0.0
# 使用清华镜像加速
pip install openclaw -i https://pypi.tuna.tsinghua.edu.cn/simple

方式2：从源码安装（开发版）

# 克隆仓库
git clone https://github.com/opencLAW/OpenClaw.git
cd OpenClaw
# 安装依赖
pip install -r requirements.txt
# 安装为可执行程序
pip install -e .

方式3：使用Docker安装

# 拉取官方镜像
docker pull openclaw/openclaw:latest
# 运行容器
docker run -it --rm \
  -v $(pwd):/workspace \
  openclaw/openclaw:latest \
  openclaw --help

模型下载与配置

自动下载（首次运行自动触发）

# 运行任意命令会自动下载所需模型
openclaw --version

手动下载模型

# 下载预训练模型
openclaw download-model base-zh
# 下载特定任务模型
openclaw download-model --model legal-bert
openclaw download-model --model ner-model

配置模型路径

# 查看当前配置
openclaw config show
# 设置模型路径
openclaw config set model_dir /path/to/models
# 设置缓存路径
openclaw config set cache_dir /path/to/cache

验证安装

检查版本

openclaw --version
# 输出示例：OpenClaw 1.0.0 (Python 3.9.13)

运行测试命令

# 测试基本功能
openclaw test
# 运行示例
openclaw example

查看帮助

# 查看所有命令
openclaw --help
# 查看子命令帮助
openclaw analyze --help
openclaw extract --help
openclaw compare --help

常用命令示例

法律文档分析

# 分析单个文档
openclaw analyze document.pdf --output result.json
# 批量处理
openclaw analyze /path/to/documents/ --format json
# 提取关键信息
openclaw extract clauses contract.docx

文本处理

# 中文分词
openclaw tokenize "这是一个法律文本示例"
# 实体识别
openclaw ner "北京市海淀区人民法院于2023年作出判决"

配置文件

# 生成配置文件
openclaw init
# 编辑配置
vim ~/.openclaw/config.yaml

故障排除

常见问题

1. ImportError: No module named 'torch'

   pip install torch torchvision

2. CUDA相关错误

   # 安装CUDA版本
   pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118

3. 权限问题

   # 使用用户安装
   pip install --user openclaw
   # 或创建虚拟环境
   python -m venv openclaw-env
   source openclaw-env/bin/activate  # Linux/macOS
   openclaw-env\Scripts\activate  # Windows

获取帮助

# 查看文档
openclaw docs
# 查看日志
tail -f ~/.openclaw/logs/openclaw.log
# 提交issue
openclaw bug-report

升级与卸载

升级版本

pip install --upgrade openclaw

卸载

pip uninstall openclaw
# 清理配置和缓存
rm -rf ~/.openclaw
rm -rf ~/.cache/openclaw

---

注意：安装过程中请确保：

• 网络连接正常（下载模型需要）
• 磁盘空间充足（模型文件较大）
• 如有GPU，确保CUDA版本匹配

如需更详细的安装指导,请参考官方文档：

https://docs.openclaw.ai/installation

标签： Homebrew 包管理器