重要提示:由于项目迭代,历史版本可能存在依赖不兼容、功能缺失或已知Bug,推荐优先使用最新版本以获得最佳体验和支持,如果需要使用历史版本,请务必查看对应版本的README文档。

以下是获取和使用OpenClaw历史版本的通用方法,分为几个步骤:
通过PyPI安装(针对已发布的版本)
如果你的目标历史版本已经发布到PyPI,这是最简洁的方法。
-
创建并激活虚拟环境(强烈推荐)
# 使用conda conda create -n openclaw_old python=3.10 # 请根据版本要求指定Python版本 conda activate openclaw_old # 或使用venv python -m venv openclaw_old_env source openclaw_old_env/bin/activate # Linux/Mac # openclaw_old_env\Scripts\activate # Windows
-
使用pip安装指定版本 在项目的PyPI页面查找可用的历史版本号。
pip install openclaw==<具体版本号> # pip install openclaw==1.5.0
-
运行
openclaw
通过GitHub源码安装(最可靠的方法)
这是使用历史版本最推荐的方法,可以确保代码和依赖完全对应。
-
访问GitHub仓库 前往官方仓库:https://github.com/OpenClaw/OpenClaw (注意:请核实最新的官方仓库地址,名称可能为
claw-machine,AI-xiaolongxia或OpenClaw,以项目最新情况为准) -
查找历史版本
- 分支 (Branches):查看不同的开发分支(如
legacy,v1.x,dev等)。 - 标签 (Tags):查看已发布的版本标签(如
v1.0.0,v2.1.0)。这是最常用的方式。 - 提交历史 (Commits):通过提交哈希锁定特定节点。
- 分支 (Branches):查看不同的开发分支(如
-
克隆并切换到特定版本
# 克隆主仓库 git clone https://github.com/OpenClaw/OpenClaw.git cd OpenClaw # 查看所有标签 git tag -l # 切换到特定标签(v1.5.0) git checkout tags/v1.5.0 # 或者切换到特定分支 # git checkout legacy-v1
-
安装依赖并运行
# 仔细阅读该版本目录下的 README.md 和 requirements.txt # 通常的安装方式 pip install -r requirements.txt # 或者,如果项目使用 setup.py 或 pyproject.toml,以可编辑模式安装 pip install -e . # 运行 # 根据历史版本的启动方式,可能是: python main.py # 或 python app.py # 或直接运行安装后生成的命令 claw
关键注意事项
- 依赖管理:历史版本的依赖库(如
torch,transformers,gradio)可能要求较低的版本,直接安装可能会与现有环境冲突。务必使用虚拟环境,并严格按照历史版本中的requirements.txt安装。 - 配置方式:不同版本的配置文件(如
config.yaml,.env)格式和位置可能不同,你需要参考历史版本的文档或示例配置文件进行设置(例如API密钥的配置方式)。 - 功能差异:
- 早期版本:可能只包含核心的对话功能,没有后期加入的代码解释器、图像生成、联网搜索等模块。
- 架构变化:项目可能从单文件脚本演变为模块化包,启动命令和参数可能发生变化。
- 已知问题:在GitHub的 Issues 或 Pull Requests 中,搜索对应版本标签,可能会发现已知的Bug和临时解决方案。
版本使用示例(假设)
假设你想使用一个古老的、基于命令行的 v0.5.0 版本:
cd OpenClaw git checkout tags/v0.5.0 # 2. 查看特定版本的说明 cat README.md # 3. 安装依赖(注意Python版本) pip install -r requirements.txt # 4. 根据旧版说明,可能需要复制配置文件模板 cp config.example.yaml config.yaml # 然后编辑 config.yaml,填入你的API密钥 # 5. 按照旧版方式启动 python cli.py --model gpt-3.5-turbo
总结建议
- 明确需求:你为什么需要历史版本?是为了复现某个旧功能,还是因为环境兼容性问题?
- 阅读文档:目标版本目录下的
README.md是最高指南,任何教程都不如它准确。 - 利用虚拟环境:为每个历史版本创建独立的虚拟环境,避免污染主环境。
- 社区求助:如果遇到问题,可以去项目的GitHub Issues或相关社区(如Discord、QQ群)搜索或提问,并注明你使用的具体版本号。
希望这些方法能帮助你顺利运行所需的OpenClaw历史版本!
标签: 切换