版本兼容说明
OpenClaw v0.8.0 版本兼容性和升级指南
✨
系统要求
| 操作系统 | 最低版本 | 推荐版本 | 架构支持 |
|---|---|---|---|
| macOS | 12.0 (Monterey) | 14.0+ (Sonoma) | x86_64, arm64 (Apple Silicon) |
| Linux | Kernel 4.15+ | Kernel 5.15+ | x86_64, arm64, armv7 |
| Windows | 10 21H2 | 11 22H2+ | x86_64 (PowerShell/WSL2) |
运行环境要求
| 环境 | 最低版本 | 推荐版本 | 备注 |
|---|---|---|---|
| Node.js | 22.16.0 LTS | 24.x 最新版本 | Node 18.x/20.x 兼容支持，建议使用LTS版本 |
| Git | 2.25.0 | 2.40+ | 技能安装和更新需要 |
硬件要求
| 部署类型 | 最低配置 | 推荐配置 | 支持并发 |
|---|---|---|---|
| 个人使用 | 2 CPU / 2GB RAM | 4 CPU / 4GB RAM | 1-5 用户 |
| 团队使用 | 4 CPU / 8GB RAM | 8 CPU / 16GB RAM | 10-50 用户 |
| 企业级部署 | 16 CPU / 32GB RAM | 32 CPU / 64GB RAM+ | 100+ 用户 |
* 若使用本地大语言模型，需要额外的显存资源：7B模型建议8GB+显存，13B模型建议16GB+显存，70B模型建议48GB+显存。
版本兼容性矩阵
| OpenClaw 版本 | Node.js 兼容版本 | 技能 API 版本 | 插件 API 版本 | 支持状态 |
|---|---|---|---|---|
| v0.8.x (当前) | 18.x, 20.x, 22.x | v3 | v2 | ✅ 活跃支持 |
| v0.7.x | 18.x, 20.x | v2, v3 | v1, v2 | ⚠️ 维护支持 |
| v0.6.x 及更早 | 16.x, 18.x | v1 | v1 | ❌ 不再支持 |
• 活跃支持：持续接收功能更新、安全补丁和Bug修复。
• 维护支持：仅接收安全补丁和严重Bug修复，无新功能更新。建议升级到最新版本。
• 不再支持：停止所有更新，存在安全风险，强烈建议立即升级。
模型支持列表
商用闭源模型 ✨ v0.8.0新增
- ✅OpenAI GPT-3.5-turbo, GPT-4o, GPT-5.1-codex
- ✅Anthropic Claude 3.5 Opus/Sonnet/Haiku
- ✅Google Gemini 2.0 Pro/Flash/Ultra
- ✅字节跳动豆包 4.0 系列
- ✅MiniMax 2.5 系列模型
- ✅Moonshot AI 月之暗面 Kimi 系列
- ✅百度文心一言 4.0 / 阿里通义千问 3.0
- ✅腾讯混元 / 智谱清言 GLM 4 系列
💡 支持多API密钥自动轮换，应对速率限制
开源模型 & 本地部署
- ✅Llama 3/3.1 系列 (7B/8B/70B/405B)
- ✅Mistral / Mixtral 系列模型
- ✅Qwen 2 / Qwen 2.5 通义千问开源系列
- ✅DeepSeek V2 / V3 系列（代码模型优化）
- ✅GLM-4-9B / Yi 34B 等国产开源模型
- ✅Phi 3 / Gemma 小模型系列
- ✅Ollama 集成：本地运行100+开源模型
- ✅所有兼容 OpenAI API 格式的模型
v0.8.0 升级指南
从 v0.7.x 升级到 v0.8.x
- 备份数据（重要）
cp -r ~/.openclaw ~/.openclaw.backup.v0.7
- 升级 OpenClaw 版本
npm install -g openclaw@latest
- 自动升级配置文件
v0.8.0 新增了网关配置、多模型调度、节点管理等配置项，运行以下命令自动升级：
openclaw config upgrade
- 重新运行入门向导（可选）
建议重新运行向导配置新功能，如服务自动安装、节点配对等：
openclaw onboard --install-daemon
- 升级技能和插件
openclaw skills upgrade --all openclaw plugins upgrade --all
- 验证升级成功
openclaw status openclaw gateway status
注意： v0.8.0 推荐使用 Node.js 22.16+ LTS 版本，Node 18.x/20.x 兼容但不建议长期使用。
从 v0.6.x 或更早版本升级
由于架构改动较大，建议全新安装，然后迁移数据：
- 备份旧版本数据：
~/.openclaw目录 - 卸载旧版本：
npm uninstall -g openclaw - 全新安装最新版本：
npm install -g openclaw - 手动迁移需要的会话、配置和技能数据
- 重新安装需要的技能和插件
警告： v0.6.x 及更早版本的技能和插件与新版本不兼容，需要重新安装兼容版本。
平台兼容性
💬 聊天渠道
- ✅Web 控制面板
- ✅REST API / WebSocket API
- ✅飞书 / Lark
- ✅iMessage (BlueBubbles)
- ✅Discord / Slack
- ✅Telegram / WhatsApp
- ✅企业微信 / 钉钉
- ✅LINE / Google Chat / IRC
🔌 所有渠道均支持插件扩展
☁️ 部署平台
- ✅裸机服务器
- ✅Docker / Docker Compose
- ✅Kubernetes
- ✅Vercel
- ✅Netlify
- ✅阿里云 ECS/Serverless
- ✅腾讯云 CVM/云函数
- ✅AWS EC2/Lambda
💾 数据库支持
- ✅本地文件存储 (默认)
- ✅SQLite
- ✅PostgreSQL
- ✅MySQL
- ✅MongoDB
- ✅Redis (缓存)
- ✅Chroma (向量数据库)
- ✅Pinecone (向量数据库)
已知兼容性问题
- ⚠️
iMessage 编辑功能
macOS 15.x (Tahoe) 版本的 iMessage 编辑/撤回功能暂时不可用，正在修复中。
- ⚠️
Node.js 奇数版本支持
Node.js 21.x/23.x 等奇数版本可能存在兼容性问题，建议使用 LTS 版本（22.x/24.x）。
- ⚠️
Windows WSL1 支持
WSL1 环境下部分工具调用功能受限，建议升级到 WSL2 以获得完整功能支持。