OpenClaw から移ってくる

hermes claw migrate は、OpenClaw（あるいは古い Clawdbot / Moldbot）の環境を Hermes に取り込みます。この案内では、何が移るのか、設定のキーがどう対応するのか、移したあとに何を確かめるのかを、ひとつずつ見ていきます。

手早く始める

# Preview then migrate (always shows a preview first, then asks to confirm)
hermes claw migrate

# Preview only, no changes
hermes claw migrate --dry-run

# Full migration including API keys, skip confirmation
hermes claw migrate --preset full --migrate-secrets --yes

移行は必ず、何を取り込むかをひととおり見せてから、実際の変更に入ります。一覧を確かめてから、進めるかどうかを答えてください。

読み取り元は既定で ~/.openclaw/ です。古い ~/.clawdbot/ や ~/.moltbot/ のディレクトリは自動で見つけます。古い設定ファイル名（clawdbot.json、moltbot.json）も同様です。

オプション

何が移るのか

人格、記憶、指示

ワークスペースのファイルは、workspace.default/ と workspace-main/ も控えの置き場として探します（OpenClaw は最近のバージョンで workspace/ を workspace-main/ に改名し、複数エージェントの構成では workspace-{agentId} を使います）。

スキル（4 か所）

スキルがぶつかったときの扱いは --skill-conflict で決まります。skip は Hermes 側のスキルをそのまま残し、overwrite は置き換え、rename は -imported を付けた写しを作ります。

モデルとプロバイダーの設定

エージェントの振る舞い

セッションを区切る決まり

補足: OpenClaw には session.resetTriggers（["daily", "idle"] のような素朴な文字列の配列）もあります。構造のある session.reset が無い場合、移行はこの resetTriggers から推し量ります。

MCP のサーバー

TTS（読み上げ）

TTS の設定は、OpenClaw の2 か所から、この優先順で読み取ります。

1. messages.tts.providers.{provider}.*（正式な置き場）
2. いちばん外側の talk.providers.{provider}.*（控え）
3. 古い平たいキー messages.tts.{provider}.*（いちばん古い書き方）

メッセージのプラットフォーム

そのほかの設定

保管されるもの（Hermes に対応するものが無いため）

次のものは、あとで自分で見られるように ~/.hermes/migration/openclaw/<timestamp>/archive/ に保存されます。

API キーの探し方

--migrate-secrets を付けると、API キーは4 か所から、この優先順で集められます。

1. 設定の値 — openclaw.json の models.providers.*.apiKey と、TTS のプロバイダーのキー
2. 環境変数のファイル — ~/.openclaw/.env（OPENROUTER_API_KEY、ANTHROPIC_API_KEY などのキー）
3. 設定の中の env — openclaw.json の "env" か "env"."vars"（別の .env ではなくここに入れている構成があります）
4. 認証のプロファイル — ~/.openclaw/agents/main/agent/auth-profiles.json（エージェントごとの資格情報）

いちばん強いのは設定の値です。そのあとの取り込み元が、残った空きを順に埋めていきます。

移せるキーの一覧

OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEY、GEMINI_API_KEY、ZAI_API_KEY、MINIMAX_API_KEY、ELEVENLABS_API_KEY、TELEGRAM_BOT_TOKEN、VOICE_TOOLS_OPENAI_KEY

この一覧に無いキーは、決してコピーされません。

SecretRef の扱い

OpenClaw の設定では、トークンや API キーの値を 3 通りの形で書けます。

// Plain string
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// Environment template
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// SecretRef object
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

移行は 3 つとも読み解きます。環境変数のひな形と、source: "env" の SecretRef については、~/.openclaw/.env と openclaw.json の env の中から値を探します。source: "file" や source: "exec" の SecretRef は自動では解けません。移行はこれらについて警告を出すので、その値は hermes config set で自分で Hermes に入れてください。

移行のあとに

1. 移行の報告を確かめる — 終わったところで、移したもの、飛ばしたもの、ぶつかったものの数が表示されます。

1. 保管されたファイルを見る — ~/.hermes/migration/openclaw/<timestamp>/archive/ に入っているものは、自分で手を入れる必要があります。

1. 新しいセッションを始める — 取り込んだスキルと記憶の項目が効くのは、今のセッションではなく新しいセッションからです。

1. API キーを確かめる — hermes status を実行して、プロバイダーの認証が通っているか見てください。

1. メッセージ連携を試す — プラットフォームのトークンを移したなら、ゲートウェイを再起動します: systemctl --user restart hermes-gateway

1. セッションの決まりを確かめる — hermes config show を実行して、session_reset の値が思ったとおりか見てください。

1. WhatsApp を紐づけ直す — WhatsApp はトークンではなく QR コードでの紐づけ（Baileys）です。hermes whatsapp を実行して紐づけてください。

1. 後片づけ — すべて動くことを確かめたら、hermes claw cleanup を実行して、残った OpenClaw のディレクトリを .pre-migration/ に改名します（どちらの状態を見ているのか分からなくなるのを防げます）。

うまくいかないとき

「OpenClaw のディレクトリが見つからない」と出る

移行は ~/.openclaw/、次に ~/.clawdbot/、次に ~/.moltbot/ を探します。別の場所に入れているなら、--source /path/to/your/openclaw で指定してください。

「プロバイダーの API キーが見つからない」と出る

キーの置き場は、OpenClaw のバージョンによっていくつかあります。openclaw.json の models.providers.*.apiKey に直接、~/.openclaw/.env の中、openclaw.json の "env" の中、あるいは agents/main/agent/auth-profiles.json です。移行はこの 4 か所すべてを見ます。キーが source: "file" や source: "exec" の SecretRef になっている場合は自動では解けないので、hermes config set で入れてください。

移行したのにスキルが出てこない

取り込まれたスキルは ~/.hermes/skills/openclaw-imports/ に入ります。効かせるには新しいセッションを始めるか、/skills を実行して読み込まれているか確かめてください。

TTS の声が移っていない

OpenClaw は TTS の設定を 2 か所に持っています。messages.tts.providers.* と、いちばん外側の talk の設定です。移行は両方を見ます。声の ID を OpenClaw の画面から設定していた場合（別のパスに保存されます）は、自分で入れる必要があるかもしれません: hermes config set tts.elevenlabs.voice_id YOUR_VOICE_ID。