tutorial migration

從 OpenClaw 遷移到 ZeroClaw:給受夠了的使用者的完整指南

ZeroClaws.io

ZeroClaws.io

@zeroclaws

February 25, 2026

6 分鐘

從 OpenClaw 遷移到 ZeroClaw:給受夠了的使用者的完整指南

決定遷移通常發生在三個時刻之一。你讀到了 CVE-2026-25253,意識到你的 OpenClaw 實例一直暴露在網路上。你查看了伺服器的記憶體使用量,發現 OpenClaw 在一台只有 2GB 記憶體的機器上閒置時佔用了 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 ```

步驟二:執行遷移工具

永遠先做乾跑。它會精確地告訴你什麼將被匯入、什麼將被跳過,以及什麼需要手動處理——而不做任何變更:

```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 橋接函式庫。重新掃描 QR 碼:`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 | |--------|----------|----------| | 記憶體使用量 | ~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 分鐘。你回收的記憶體是立即的。CVE 暴露在 OpenClaw 停止執行的那一刻就結束了。

保持關注

獲取新版本、整合和 Rust 驅動的 Agent 基礎設施更新。不發垃圾郵件,隨時退訂。