OpenClaw からの移行
OpenClaw からの移行 — 公式ドキュメントに基づくわかりやすいガイド
新しい家への引っ越しはストレスがたまるもの。でも、もし引っ越し業者が荷物を箱に詰めて、ラベルを貼って、家具を階段まで運んでくれたらどうでしょう?Hermes Agentの移行ツールは、まさにその「頼れる引っ越し業者」です。OpenClaw(または旧バージョンのClawdbotやMoldbot)から乗り換えるときも、手動でコピーする必要も、思い出を失うことも、涙することもありません。
移行ツールは何をするの?
hermes claw migrate は、あなた専属の引っ越しクルーだと思ってください。古いOpenClaw環境(通常は ~/.openclaw/)からすべてを読み取り、新しいHermesのホーム(~/.hermes/)にきれいに配置します。移行されるのは以下のもの:
- 性格と指示 –
SOUL.mdファイル(エージェントの「キャラクター」)はそのままコピーされます。 - ワークスペースルール –
AGENTS.mdファイル(プロジェクト内でのエージェントの振る舞い方)は、指定した場所に移動します。 - 長期記憶 –
MEMORY.mdファイルは個別のエントリに解析され、既存の記憶と統合され、重複も排除されるので、同じ記憶が繰り返し出てくることはありません。
始めるのはカンタン
ターミナルを開いて、次のコマンドを実行するだけ:
hermes claw migrate
ツールが移行予定のすべての項目のプレビューを表示します。リストを確認して「yes」と入力すれば完了です。本当に簡単です。
実行前に確認したい?
変更が不安な場合は、まずドライラン(予行演習)を実行しましょう:
hermes claw migrate --dry-run
これは何も変更せずに完全な計画を表示します。賃貸契約を結ぶ前に新しいアパートを下見するようなものです。
APIキーの移行(任意ですが重要)
デフォルトでは、移行ツールはAPIキー(OpenAIやAnthropicの認証情報など)をコピーしません。それらも移行したい場合は、明示的に指定する必要があります:
hermes claw migrate --preset full --migrate-secrets --yes
--migrate-secrets フラグは安全スイッチです。キーがあなたの知らないうちに静かに移動されることは絶対にありません。
何か問題が起きたら?
Hermesがしっかり守ってくれます。変更を適用する前に、現在の ~/.hermes/ フォルダのバックアップzipを作成します。何かおかしいと感じたら、次のコマンドで復元できます:
hermes import
このバックアップは ~/.hermes/backups/pre-migration-*.zip に保存されます。アパートの「before」写真を持っているようなもので、いつでも元の状態に戻せます。
ちょっとした追加のヒント
- レガシーユーザーへ:
~/.clawdbot/や~/.moltbot/から移行する場合も心配いりません。Hermesがこれらのフォルダを自動的に検出します。 - 競合が発生したら? 既存のファイルが見つかった場合、デフォルトでは上書きを拒否します。
--overwriteで強制するか、--skill-conflict renameで競合ファイルをリネームして対応できます。 - マルチプロバイダー構成: 以前に複数のAIプロバイダーを使用していた場合、
hermes setup --portalを使えば、300以上のモデルにアクセスできる1つのOAuthログインにすべてを統合できます。
まとめ
移行は頭痛の種である必要はありません。hermes claw migrate を使えば、プレビュー表示、安全なバックアップ、エージェントの性格・記憶・ルールのクリーンな移行が、すべて1つのコマンドで完了します。
実用的なヒント: まず hermes claw migrate --dry-run を実行してリストを慎重に確認し、その後で実際の移行を実行しましょう。バックアップzipは少なくとも1週間は安全な場所に保管しておくことをおすすめします。未来の自分がきっと感謝してくれるはずです。
📖 公式ドキュメント
この記事は Hermes Agent の公式ドキュメントに基づいています:公式ドキュメント › guides/migrate-from-openclaw