English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Hermesからの移行

OpenClaw は、同梱の移行プロバイダーを通じて Hermes の状態をインポートします。このプロバイダーは状態を変更する前にすべてをプレビューし、計画とレポート内のシークレットを伏せ字にし、適用前に検証済みバックアップを作成します。

インポートする 2 つの方法

オンボーディング ウィザード

最短の方法です。ウィザードは ~/.hermes にある Hermes を検出し、適用前にプレビューを表示します。

openclaw onboard --flow import

または、特定のソースを指定します。

openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

スクリプト化された実行や反復可能な実行には openclaw migrate を使用します。完全なリファレンスは openclaw migrate を参照してください。

openclaw migrate hermes --dry-run    # preview only
openclaw migrate apply hermes --yes  # apply with confirmation skipped

Hermes が ~/.hermes 以外にある場合は --from <path> を追加します。

インポートされる内容

モデル設定
  • Hermes の config.yaml からのデフォルトモデル選択。
  • providers と custom_providers からの、設定済みモデルプロバイダーとカスタム OpenAI 互換エンドポイント。
MCP サーバー

mcp_servers または mcp.servers からの MCP サーバー定義。

ワークスペースファイル
  • SOUL.md と AGENTS.md は OpenClaw エージェントワークスペースにコピーされます。
  • memories/MEMORY.md と memories/USER.md は、上書きされるのではなく、対応する OpenClaw メモリファイルに追記されます。
メモリ設定

OpenClaw ファイルメモリ用のメモリ設定のデフォルトです。Honcho などの外部メモリプロバイダーは、意図的に移動できるようにアーカイブまたは手動レビュー項目として記録されます。

Skills

skills/<name>/ 配下に SKILL.md ファイルがある Skills は、skills.config からの Skill ごとの設定値とともにコピーされます。

API キー (オプトイン)

対応する .env キーをインポートするには --include-secrets を設定します: OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY。このフラグがない場合、シークレットは一切コピーされません。

アーカイブ専用として残る内容

プロバイダーは手動レビュー用にこれらを移行レポートディレクトリへコピーしますが、稼働中の OpenClaw 設定や認証情報には読み込みません。

  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db

形式や信頼の前提がシステム間でずれる可能性があるため、OpenClaw はこの状態を自動的に実行したり信頼したりすることを拒否します。アーカイブを確認した後、必要なものを手動で移動してください。

推奨フロー

  • 計画をプレビューする

    openclaw migrate hermes --dry-run

    計画には、競合、スキップされた項目、機密項目を含め、変更されるすべての内容が一覧表示されます。計画出力では、ネストされたシークレットらしいキーが伏せ字になります。

  • バックアップ付きで適用する

    openclaw migrate apply hermes --yes

    OpenClaw は適用前にバックアップを作成し、検証します。API キーもインポートする必要がある場合は、--include-secrets を追加します。

  • doctor を実行する

    openclaw doctor

    Doctor は、保留中の設定移行を再適用し、インポート中に発生した問題がないか確認します。

  • 再起動して検証する

    openclaw gateway restart
openclaw status

    Gateway が正常で、インポートしたモデル、メモリ、Skills が読み込まれていることを確認します。

    • 競合の処理

    計画で競合 (ファイルまたは設定値がターゲットにすでに存在すること) が報告された場合、適用は続行を拒否します。

    新しい OpenClaw インストールでは、競合は通常発生しません。通常は、すでにユーザー編集があるセットアップでインポートを再実行したときに現れます。

    適用の途中で競合が発生した場合 (たとえば、設定ファイル上の予期しない競合状態)、Hermes は依存する残りの設定項目を部分的に書き込む代わりに、理由 blocked by earlier apply conflict 付きで skipped としてマークします。移行レポートにはブロックされた各項目が記録されるため、元の競合を解決してインポートを再実行できます。

    シークレット

    シークレットはデフォルトでは一切インポートされません。

    • まず openclaw migrate apply hermes --yes を実行して、シークレット以外の状態をインポートします。
    • 対応する .env キーもコピーしたい場合は、--include-secrets を付けて再実行します。
    • SecretRef 管理の認証情報については、インポート完了後に SecretRef ソースを設定してください。

    自動化向け JSON 出力

    openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes

    --json を指定し、--yes を指定しない場合、適用は計画を出力し、状態を変更しません。これは CI と共有スクリプトにとって最も安全なモードです。

    トラブルシューティング

    適用が競合で拒否される

    計画出力を確認してください。各競合には、ソースパスと既存のターゲットが示されます。項目ごとに、スキップするか、ターゲットを編集するか、--overwrite を付けて再実行するかを決めてください。

    Hermes が ~/.hermes 以外にある

    --from /actual/path (CLI) または --import-source /actual/path (オンボーディング) を渡します。

    既存のセットアップでオンボーディングがインポートを拒否する

    オンボーディングによるインポートには新しいセットアップが必要です。状態をリセットして再度オンボーディングするか、--overwrite と明示的なバックアップ制御をサポートする openclaw migrate apply hermes を直接使用してください。

    API キーがインポートされなかった

    --include-secrets が必要で、上記に一覧されたキーのみが認識されます。.env 内のその他の変数は無視されます。

    関連