Tutorial Migration

OpenClaw から Hermes Agent へ——ステップごとの移行手順

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 分で読める

これまで OpenClaw を走らせてきたなら、Hermes Agent はその後継だ。プロジェクトの血筋は地続きで、メンテナも同じ顔ぶれ、そこに改名と再設計が乗っている。Hermes のインストーラはそのことを認識していて——v0.14.0 にはファーストクラスの hermes claw migrate コマンドが乗っている。既存の OpenClaw の状態を一発で取り込み、dry-run と明示的なプリセットに対応する。

この記事はその実践ガイドだ:何が引き継がれるか、どんなフラグがあるか、そして驚かないための「まず dry-run」流儀。

1. Hermes Agent をインストール

Hermes のセットアップウィザードは ~/.openclaw を自動検出し、設定が始まる前に「移行しますか」と聞いてくる。最短経路:

bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup

ウィザードが OpenClaw のホームディレクトリを見つけたら、移行するか問い合わせてくる。素直に yes でいい——だが「何が移ってくるのか先に正確に知りたい」なら、ウィザードを抜けて migrate コマンドを直接叩くのが筋だ。

2. --dry-run でプレビュー

これは必ず先に走らせる。ディスクに何も書かずに、移行ツールが取り込むつもりのものを全て列挙する:

bash
hermes claw migrate --dry-run

出力はカテゴリで分かれる——SOUL.md、memory、skill、許可リスト、メッセージング設定、API key、TTS 素材。一度目を通す。何か違和感があれば(移したくない古い API key、自分が卒業したパーソナリティファイルなど)、プリセットを使ってそのセクションを飛ばす。

3. プリセットを選ぶ

デフォルトで 2 つのプリセットが付いてくる:

  • full(既定)——シークレットを含めて全部移行
  • user-data——API key を除いて全部移行;シークレットは自分で再入力

新しいマシンへ引っ越して、シークレットは綺麗に断ち切りたい? user-data を使う:

bash
hermes claw migrate --preset user-data

同じマシンを単に上げて連続性を保ちたい?

bash
hermes claw migrate

4. 何が引き継がれるか

README の対応表に従う:

OpenClawHermes 側の宛先
SOUL.md(人格)そのまま取り込み
MEMORY.mdUSER.md のエントリHermes の memory に取り込み
ユーザ作成 skill~/.hermes/skills/openclaw-imports/ にコピー
コマンド許可リスト(承認パターン)取り込み
メッセージング設定(プラットフォーム設定、許可ユーザ、作業ディレクトリ)取り込み
API key(Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs)プリセット full のとき取り込み
TTS 素材(ワークスペースの音声ファイル)取り込み
ワークスペース AGENTS.md--workspace-target 付きで取り込み

agentskills.io 由来の skill は自動では再インストールされない——Hermes は「自分でハブをもう一度眺めて、hermes skills で欲しいものを選び直すだろう」と仮定している。これは意図的だ:OpenClaw → Hermes の改名は同時に skills hub も改修した(v0.14.0 で huggingface/skills が信頼デフォルトの tap に昇格)し、まとめて持ち越すより、選び直す方が綺麗だ。

5. 衝突の処理

このマシンに既に Hermes の設定がある場合(例えば、OpenClaw の存在を忘れて先に hermes setup を走らせたケース)、migrate は既定で上書きを拒否する。2 つの選択肢:

  • --overwrite——OpenClaw 側の値で Hermes 側の設定を上書きする
  • 衝突しているカテゴリをスキップ——衝突がシークレット側なら --preset user-data を使う

--overwrite は、--dry-run で OpenClaw 側の値が本当に自分の欲しいものだと確認した後でしか使わない。

6. 確認

bash
hermes doctor

これがインストール後のヘルスチェックを走らせる。memory、skill、許可リスト、プラットフォーム設定があるべき場所にないなら、具体的なエラーが出る。直して、再実行して、次に進む。

代替:エージェント主導の移行

CLI のフラグを触りたくないなら、Hermes は openclaw-migration という skill を持っている:

bash
hermes
> /openclaw-migration

この skill は同じ移行を対話形式でなぞる——各ステップで --dry-run のプレビュー付きで。

よくある質問

OpenClaw のデータは失われる? いいや。移行ツールはコピーする——移動はしない。~/.openclaw のディレクトリは触らない。何か壊れたら、~/.hermes を消して OpenClaw に戻ればいい。

両方を同時に走らせていい? 短期間ならいい。HOME についての前提を共有しているので、同じ memory を両方が同時に所有することは想定されていない。長期の二重運用なら、コミュニティの HermesClaw ブリッジが同じ WeChat アカウント上での OpenClaw と Hermes の共存を捌く。

自分の skill は壊れる? ユーザ作成の skill は ~/.hermes/skills/openclaw-imports/ にコピーされるので、移動を生き延びる。agentskills.io から取った skill はハブ側に紐づいていてローカル側ではない——hermes skills で再インストールする。

何か壊れたらどこに助けを求める? まず hermes doctor。次は Nous Research DiscordGitHub Issues——どちらも README からリンクされている。

もっと読む

アップデートを購読

Hermes Agent の新リリース、新しいスキル、新しい統合をコミュニティの視点でお届け。スパムなし、いつでも解除できる。