决定迁移通常发生在三个时刻之一。你读到了 CVE-2026-25253，意识到你的 OpenClaw 实例一直暴露在公网上。你检查了服务器的内存使用情况，发现 OpenClaw 在一台 2GB RAM 的机器上空闲时占用了 1.2GB。或者你看到了那篇 XDA Developers 的文章，决定不想等着看下一个漏洞长什么样。
不管是什么让你来到这里，迁移过程都很简单。ZeroClaw 内置了一个迁移工具来处理繁重的工作。下面是你可以期待的内容。
什么能带过去
迁移工具将你的对话历史导入 ZeroClaw 的 SQLite 记忆数据库。你的频道连接——Telegram、Discord、WhatsApp token——以 config.toml 格式带过去。你的 AI 提供商设置和 API 密钥直接转移。系统提示和角色配置干净地转换。
你不会失去的是你的上下文。你进行过的对话、你的助手了解到的你的偏好、它随时间积累的记忆——这些都跟你一起来。
实际上会变什么
最大的变化是插件系统。OpenClaw 的 JavaScript 插件不能在 ZeroClaw 中运行。大多数常见的内置插件都有 ZeroClaw 等价物——你可以用 `zeroclaw tools list` 检查。对于你自己编写的自定义插件，你需要找到内置等价物或实现一个 Rust trait。对于简单的自动化，shell 工具让你可以调用外部脚本而不需要写 Rust。
第二个变化是界面。ZeroClaw 不附带 Web UI。你通过聊天频道或 CLI 交互。如果你严重依赖 OpenClaw 的 Web 界面，有一个社区 Web 网关提供类似功能，但主要的交互模型是频道优先的。
其他一切都更简单了。没有 node_modules，没有依赖管理，没有插件市场。集成在 TOML 文件中配置，而不是从注册表安装。一个二进制文件，一个配置文件，一个数据库。
开始之前
在运行任何东西之前花五分钟准备：
```bash # 检查你当前的 OpenClaw 版本 openclaw --version
# 将你的记忆导出为备份 openclaw export --format json > openclaw-backup.json
# 将你的 .env 文件保存到安全的地方 cp ~/.openclaw/.env ~/openclaw-env-backup ```
还要记下你的活跃频道 token 和你构建的任何自定义插件。迁移工具自动处理大多数事情，但如果有任何需要手动处理的地方，有一个参考很有用。
第一步：安装 ZeroClaw
```bash # macOS brew install zeroclaw
# Linux curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
# Windows curl -fsSLO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-x86_64-pc-windows-msvc.zip ```
第二步：运行迁移工具
始终先做 dry run。它向你展示将被导入什么、将被跳过什么、需要手动处理什么——而不做任何更改：
```bash zeroclaw migrate openclaw --dry-run ```
仔细阅读输出。如果有任何看起来不对的地方，你可以在提交之前处理它。当你满意时：
```bash zeroclaw migrate openclaw ```
这会导入你的对话记忆、频道配置、AI 提供商设置和系统提示。默认导入最近 10,000 条消息。要获取完整历史，添加 `--full-history`。
第三步：验证配置
打开 `~/.config/zeroclaw/config.toml` 并验证迁移是否正确获取了所有内容：
```toml [ai] provider = "anthropic" # 或 "openai"、"ollama" 等 model = "claude-sonnet-4-20250514" api_key = "sk-ant-..."
[channels.telegram] token = "123456:ABC..." allowed_users = [your_user_id]
[channels.discord] token = "MTk..." guild_ids = [your_server_id] ```
第四步：切换前先测试
```bash zeroclaw start ```
通过每个频道发送测试消息。验证机器人是否响应，之前的对话上下文是否可用，以及是否正在使用你偏好的 AI 模型。还不要停止 OpenClaw——并行运行两者，直到你确信一切正常。
常见问题
WhatsApp 桥接无法连接。 ZeroClaw 使用不同的 WhatsApp 桥接库。重新扫描二维码：`zeroclaw channel whatsapp pair`。
自定义插件不工作。 用 `zeroclaw tools list` 检查是否存在内置等价物。对于自定义逻辑，使用 shell 工具调用外部脚本，或者为更复杂的集成实现 Rust trait。
记忆似乎不完整。 迁移默认导入最近 10,000 条消息。要获取完整历史：`zeroclaw migrate openclaw --full-history`。
配置格式令人困惑。 OpenClaw 使用 .env 文件和 JSON。ZeroClaw 使用 TOML。迁移工具自动处理转换，但如果你需要手动调整，ZeroClaw 文档有完整的配置参考。
迁移前后对比
一旦你验证一切正常，差异是立竿见影的：
| 指标 | OpenClaw | ZeroClaw | |--------|----------|----------| | RAM 使用 | ~1.2 GB | ~4 MB | | 启动时间 | ~8 秒 | <10 毫秒 | | 磁盘使用 | ~800 MB | ~12 MB | | 依赖 | 1,200+ npm 包 | 0 | | 未修复 CVE | 2+ 严重 | 0 |
收尾
一旦你确认 ZeroClaw 正常工作，停止 OpenClaw 并回收资源：
```bash # 停止 OpenClaw 服务 sudo systemctl stop openclaw
# 卸载 npm uninstall -g openclaw ```
保留你的 `openclaw-backup.json` 几周以防万一，然后在你确信不需要它时删除它。
迁移大约需要 20 分钟。你回收的 RAM 是立竿见影的。CVE 暴露在 OpenClaw 停止运行的那一刻就结束了。