2026年 Hermes Agent 長期メンテナンスのベストプラクティス：更新・ログ・バックアップと再起動復旧の完全ガイド

2. よくあるつまずき（3点）

1. 制約：無人運転 ≠ メンテ不要。macOS・Homebrew/pip・Hermes のリリース周期は揃いません。hermes update だけして検収しないと、ゲートウェイや cron が「半分だけ新しい」状態のまま残ります。
2. 隠れコスト：PATH と launchd の環境差。対話シェルでは git も node も見えるのに、launchd 管理のゲートウェイからは見えない——ログには曖昧なツールエラーだけが残ります。
3. 安定性と監査：バックアップがなければロールバック点もない。設定は ~/.hermes/config.yaml、.env、skills、セッション DB に分散。鍵をチャット履歴だけに置くと、ローテーション時に全経路が一度に切れます。

3. バックアップ対象一覧（更新前チェックリスト）

既定のデータディレクトリは HERMES_HOME（多くは ~/.hermes）。hermes config path と hermes config env-path で実パスを確認。プロファイルごとに home が分かれます。

推奨コマンド：日常は hermes backup --quick --label "pre-upgrade"。大きな変更前は hermes backup -o ~/hermes-backups/$(date +%F).zip。復元は hermes import。公式バックアップに Hermes コードリポジトリ本体は含まれません（git インストールと pip インストールでロールバック手順が異なります）。

4. 環境を壊さないアップグレード：周期・マトリクス・七ステップ Runbook

4.1 macOS・依存関係・Hermes の更新リズム

自動更新が常に安全とは限りません。git pull でも pip install --upgrade でも、「バックアップ → 更新 → 最小タスク検収 → ロールバック用 zip 保持」を守ってください。config.yaml の update.backup: true、または都度 hermes update --backup が使えます。

4.2 七ステップ：アップグレードと検収 Runbook

1. ベースライン記録：hermes version、hermes dump、hermes gateway status を変更チケットへ。
2. バックアップ：hermes backup --quick --label "pre-$(date +%Y%m%d)" またはフル zip。
3. 事前チェック：hermes update --check；hermes doctor --fix で自動修復可能な WARN を処理。
4. 更新実行：メンテナンス窓で hermes update --backup（git はコード取得＋依存再インストール、pip は PyPI からアップグレード）。
5. 最小検収：hermes chat -q "reply OK"；ゲートウェイ利用時は Telegram/Discord から実メッセージ 1 通。
6. 再起動テスト：hermes gateway restart；任意で Mac 再起動し launchd 自動起動を確認。
7. 失敗時ロールバック：hermes import <backup.zip>、または config/.env 復元後 hermes gateway restart；pip/git のバージョン戻しはインストール方式に従う。

5. ログとヘルスチェック

5.1 ログの場所とよく使うコマンド

既定：~/.hermes/logs/（プロファイル別は対応する HERMES_HOME/logs/）。

• agent.log — API 呼び出し、ツール配信、セッション（INFO 以上）
• errors.log — WARNING 以上。障害調査の第一候補
• gateway.log — メッセージング接続と Webhook

hermes logs list
hermes logs errors --since 30m -n 100
hermes logs gateway -f
hermes logs --level ERROR --since 2h --component tools

agent.log は agent.log.1 などへローテーションされます。30 日超の *.log.* は月次でコールドストレージへ。checkpoint シャドウリポジトリは hermes checkpoints prune --max-size-mb 500 で上限管理。

5.2 ヘルスチェック閾値（目安）

日次点検の例：hermes doctor + hermes logs errors --since 24h + df -h。外部アラートには ERROR 行を既存ログ基盤へ（JSONL サイドカー、または hermes debug share --local で手動共有）。

6. 再起動・ネット断・スリープ復帰と復旧ドリル

スリープ復帰後はまず hermes gateway status。未起動なら hermes gateway start（launchd インストール時）。ネット復旧後は gateway.log の再接続を確認。

四半期ドリル（カレンダーに登録）：

1. フル hermes backup をオフサイトへ
2. Mac 再起動 → 3 分待機 → hermes status --deep
3. メッセージングからテスト送信 + hermes cron tick（cron がある場合）
4. RTO 記録：起動からゲートウェイ利用可能まで（目安 5 分未満。モデルとログイン項目で変動）

リモート物理 Mac（ZoneMac ノードなど）では、SSH 到達性、launchd と同じユーザー、PATH に git/node が含まれることも確認——原因は OpenClaw Gateway の launchd トラブルシュートと同型の PATH 問題が多いです。

7. シークレットと権限の見直し

• API key（OpenRouter、Anthropic など）：90 日ごとにローテ。hermes auth add/remove を使い、skills に平文を書かない。
• OAuth（Codex、Anthropic、Copilot）：hermes auth status <provider>；期限切れは .env 編集ではなく再 OAuth。
• ツール権限：月次で hermes tools list；未使用の terminal/browser/MCP を無効化。
• ペアリング / Webhook：hermes pairing list で不要購読を整理。

8. 保守カレンダー（リマインダーに貼れる表）

社内 Wiki 用の引用パラメータ

• ログ既定：~/.hermes/logs/、ローテ後 agent.log.1+
• クイックバックアップ：数 MB〜数百 MB（セッション/skills 次第）；フルはディスク ≥ 2× HERMES_HOME を確保
• ゲートウェイヘルスポーリング：30〜60 秒；ERROR は 1 時間 5 行未満を初期閾値に
• checkpoint 既定上限：hermes checkpoints prune --max-size-mb 500（ディスクに合わせ調整）

FAQ

Q: brew と pip インストールでロールバックの違いは？

A: pip は前バージョンの wheel を再インストール、git は既知コミットへ git checkout して依存を入れ直します。いずれもユーザーデータの戻しは hermes import——バイナリだけ戻して config を戻さないのは避けてください。

Q: 複数プロファイルのバックアップは？

A: プロファイルごとに hermes -p <name> backup。複数ゲートウェイ更新後は hermes gateway restart --all。