CLI コマンド早見表

このページでは、シェルから打つターミナルのコマンドをまとめています。

チャットの中で使うスラッシュコマンドは スラッシュコマンド早見表 を参照してください。

全体の入口

hermes [global-options] <command> [subcommand/options]

全体に効くオプション

主なコマンド

hermes chat

hermes chat [options]

よく使うオプション:

例:

hermes
hermes chat -q "Summarize the latest PRs"          # seeds an interactive session
hermes chat --oneshot -q "Summarize the latest PRs"  # answer and exit
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills
hermes chat --quiet -q "Return only JSON"
hermes chat --worktree -q "Review this repo and open a PR"
hermes chat --ignore-user-config --ignore-rules -q "Repro without my personal setup"
hermes chat --safe-mode -q "Is this bug mine or Hermes'?"

hermes -z <prompt> — スクリプトからの 1 回きりの実行

プログラムから呼ぶとき（シェルのスクリプト、CI、cron、プロンプトを流し込む親プロセス）、hermes -z がいちばん素直な 1 回きりの入口です。プロンプトを 1 つ渡すと、最後の返答の文章だけが返り、標準出力にも標準エラーにもほかは何も出ません。 見出しも、待機表示も、ツールの下見も、Session: の行もなく、エージェントの最終的な返事だけが素の文字として出ます。

hermes -z "What's the capital of France?"
# → Paris.

# Parent scripts can cleanly capture the response:
answer=$(hermes -z "summarize this" < /path/to/file.txt)

その実行だけの上書き（~/.hermes/config.yaml は変わりません）:

hermes -z "…" --provider openrouter --model openai/gpt-5.5
# or:
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

エージェントもツールもスキルも同じで、対話や見た目のための層をすべて剥がしただけです。記録にツールの出力も残したいなら hermes chat --oneshot -q を使ってください。-z は「最終的な答えだけほしい」という用途のためのものです。

--usage-file — パイプライン向けの JSON の利用状況報告

hermes -z "…" --usage-file /path/report.json と書くと、実行のあとに機械が読める利用状況の報告を書き出します。estimated_cost_usd、input_tokens / output_tokens / cache_read_tokens / cache_write_tokens / reasoning_tokens / total_tokens、api_calls、model、provider、session_id、service_tier、それに completed / failed の印が入ります。実行が失敗したときも書き出されるので、まとめて処理するパイプラインでもつねに費用を把握できます。-z と --oneshot の外では何も起きず、報告の書き出しに失敗しても、実行そのものの結果が覆い隠されることはありません。

hermes -z "summarize this repo" --usage-file /tmp/usage.json
jq .estimated_cost_usd /tmp/usage.json

hermes model

対話的にプロバイダーとモデルを選ぶコマンドです。新しいプロバイダーの追加、API キーの設定、OAuth のやり取りはこのコマンドで行います。 動いている Hermes のチャット セッションの中ではなく、ターミナルから実行してください。

hermes model

次のようなときに使います。

• 新しいプロバイダーを足す（OpenRouter、Anthropic、Copilot、DeepSeek、独自のものなど）
• OAuth を使うプロバイダーにログインする（Anthropic、Copilot、Codex、Nous Portal）
• API キーを入力・更新する
• プロバイダーごとのモデル一覧から選ぶ
• 独自や自前のエンドポイントを設定する
• 新しい既定値を設定に保存する

/model スラッシュコマンド（セッションの途中）

セッションを抜けずに、設定済みのモデルを切り替えます。

/model                              # Show current model and available options
/model claude-sonnet-4              # Switch model (auto-detects provider)
/model zai:glm-5                    # Switch provider and model
/model custom:qwen-2.5              # Use model on your custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Use a named custom provider
/model openrouter:anthropic/claude-sonnet-4  # Switch back to cloud

既定では、/model の変更はいまのセッションだけに効きます。--global を足すと config.yaml に保存されます（model.persist_switch_by_default: true にすれば、すべての切り替えが保存されます）。

/model claude-sonnet-4 --global     # Switch and save as new default

--global で切り替えると、モデルと一緒にプロバイダーとベース URL の変更も config.yaml に保存されます。独自のエンドポイントから離れるときは、古いベース URL がほかのプロバイダーに漏れないように消されます。

hermes gateway

hermes gateway <subcommand>

サブコマンド:

オプション:

--external-supervisor は再起動の取り決めです。チャットからの再起動や、サービスの 再起動を伴う更新は終了コード 75 で終わるので、外側の仕組みの監視役が、その 0 でない終了のあとにゲートウェイを立て直す必要があります。systemd なら Restart=on-failure か Restart=always を使い、RestartPreventExitStatus に 75 を入れないでください。launchd なら、うまくいかなかった終了のあとに立て直すよう KeepAlive を設定します。この取り決めがないと、再起動を頼んでもゲートウェイは 止まったままになります。

hermes gateway enroll は --token、--connector-url、--gateway-id、--wake-url を受け付けます。登録用のトークンをコネクターと交換し、返ってきた GATEWAY_RELAY_ID、GATEWAY_RELAY_SECRET、GATEWAY_RELAY_DELIVERY_KEY、必要なら GATEWAY_RELAY_URL、そして（--wake-url を渡した場合は）GATEWAY_RELAY_WAKE_URL の値を、使っているプロファイルの .env に書きます。

hermes lsp

hermes lsp <subcommand>

Language Server Protocol の連携を管理します。LSP は本物の 言語サーバー（pyright、gopls、rust-analyzer、…）をバックグラウンドで 動かし、その診断結果を write_file と patch のあとの 確認に流し込みます。git のワークスペースを見つけたときだけ働きます。 作業ディレクトリか編集するファイルが git のワークツリーの中に あるときにしか LSP は動きません。

サブコマンド:

対応言語や設定のつまみを含めたひととおりの説明は LSP — 意味的な診断 にあります。

hermes setup

hermes setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure] [--portal]

いちばん手軽な道: hermes setup --portal — Nous Portal に OAuth でログインし、Tool Gateway を一度に有効にします。

初回: 初めての人向けのウィザードが立ち上がります。

すでに設定済みの場合: そのまま全項目を見直すウィザードに入ります。どの質問にも今の値が既定として出るので、Enter でそのまま、変えたいときだけ入力します。メニューは出ません。

ウィザード全体ではなく、一部だけを直したいとき:

オプション:

hermes portal

hermes portal [status|open|tools]

Nous Portal の認証と Tool Gateway の経路を確認し、契約のページを開きます。サブコマンドなしで実行すると status になります。

ゲートウェイそのものの設定は Tool Gateway を参照してください。一度に用意する道は、上の hermes setup --portal です。

hermes whatsapp

hermes whatsapp

WhatsApp の紐づけと設定の流れを実行します。動かし方の選択と QR コードでの紐づけも含みます。

hermes slack

hermes slack manifest              # print manifest to stdout
hermes slack manifest --write      # write to ~/.hermes/slack-manifest.json
hermes slack manifest --long-description-file AGENTS.md --write
hermes slack manifest --slashes-only  # just the features.slash_commands array

COMMAND_REGISTRY にあるゲートウェイのコマンド（/btw、/stop、/model、…）を すべて、Slack の正式なスラッシュコマンドとして登録するアプリの マニフェストを作ります。Discord や Telegram と同じ使い心地になります。出力を Slack のアプリの設定 （https://api.slack.com/apps → 自分のアプリ → Features → App Manifest → Edit）に貼り付けて Save します。権限や スラッシュコマンドが変わった場合、Slack は入れ直しを求めてきます。

hermes update のあとにもう一度 hermes slack manifest --write を実行すると、 新しいコマンドを取り込めます。

hermes send

hermes send --to <target> "message text"
hermes send --to <target> --file <path>
echo "message" | hermes send --to <target>
hermes send --list [platform]

エージェントやゲートウェイの処理を立ち上げずに、設定済みのメッセージング プラットフォームへ 1 回だけメッセージを送ります。ゲートウェイがすでに持っている認証情報（~/.hermes/.env と ~/.hermes/config.yaml）を使い回すので、運用のスクリプト、cron の作業、CI のフック、監視の常駐プロセスから、プラットフォームごとの REST クライアントを書き直さずに状況を知らせられます。

ボットのトークンで動くプラットフォーム（Telegram、Discord、Slack、Signal、SMS、WhatsApp Cloud API）では、ゲートウェイが動いている必要はありません。hermes send がプラットフォームの REST のエンドポイントに直接話しかけます。常駐のアダプターが要るプラグイン型のプラットフォームでは、動いているゲートウェイが必要です。

message の引数も --file も渡さなかった場合、hermes send は標準入力が端末でないときにそこから読みます。終了コードは、成功なら 0、配信やバックエンドの失敗なら 1、使い方の誤りなら 2 です。

画像などの添付を送る

--file は*テキスト*の本文専用です。画像、書類、動画、音声をプラットフォームの添付として届けるには、メッセージの文章の中で MEDIA:<local_path> と書いて指し示します。

hermes send --to telegram "MEDIA:/tmp/screenshot.png"
hermes send --to telegram "Build chart for today MEDIA:/tmp/chart.png"   # with caption
hermes send --to discord:#ops "MEDIA:/tmp/report.pdf"

既定では、画像ファイルは写真として送られます（Telegram などはこれを圧縮し直します）。メッセージに [[as_document]] を足すと、圧縮されないファイルの添付として届きます。

hermes send --to telegram "[[as_document]] MEDIA:/tmp/screenshot.png"

例:

hermes send --to telegram "deploy finished"
echo "RAM 92%" | hermes send --to telegram:-1001234567890
hermes send --to discord:#ops --file /tmp/report.md
hermes send --to slack:#eng --subject "[CI]" --file build.log
hermes send --list                  # all platforms
hermes send --list telegram         # filter by platform

hermes peer

hermes peer add <name> --url http://host:port --key <API_SERVER_KEY>
hermes peer list
hermes peer dm <peer>[/<agent>] "message"
hermes peer remove <name>

端末をまたいだボット同士のやり取りです。別の Hermes のゲートウェイ（api_server のプラットフォームを動かしている端末なら何でも）を*相手*として登録し、そこのエージェントに 話しかけます。hermes peer dm は相手の API サーバー越しにそのエージェントの標準の Bot Chat のセッションを見つけ、そこでエージェントのターンを 1 回動かし、返事を 標準出力に出します。手元での hermes -p <bot> chat --in ~ -c "Bot Chat" … によるボットへの呼びかけの、端末をまたぐ版です。

<peer> だけなら相手のゲートウェイの主となるエージェントに、 <peer>/<agent> なら多重化した相手の中の名前付きプロファイルに届きます（その /p/<profile>/ の写しを経由します）。

相手を 1 つでも登録すると、標準の Bot Chat すべてに教えられるボット モードのやり取りの決まり （agent.bot_mode_protocol）に、相手の一覧と hermes peer dm の書き方が自動で 含まれます。SOUL を書き換えなくても、エージェントは端末をまたいだ仲間を 見つけられます。 ボット モード を参照してください。

終了コードは、成功なら 0、配信や相手側の失敗なら 1、使い方の誤りなら 2 です。

hermes secrets

hermes secrets bitwarden <subcommand>
hermes secrets bw <subcommand>          # short alias

API キーを ~/.hermes/.env に置く代わりに、プロセスの起動時に外部の秘密の保管先から取ってきます。いまのところ Bitwarden Secrets Manager に対応しています。ひととおりの説明は Bitwarden 連携 にあります。

bitwarden（別名 bw）のサブコマンド:

hermes migrate

hermes migrate <type>

使っている config.yaml を調べ、必要なら書き換えて、廃止されたモデルや非推奨の設定への参照を置き換えます。書き換えの前には、元の config.yaml の控えが日時付きで取られます（--no-backup で省けます）。

移行のサブコマンドで共通のオプション:

> hermes claw migrate（OpenClaw の設定を Hermes に一度だけ取り込むもの）とは別ものです。hermes migrate は設定を書き換えるための最上位のコマンドです。

hermes proxy

hermes proxy <subcommand>

OAuth で認証した上流のプロバイダー（Nous Portal、xAI など）へ要求を転送する、OpenAI 互換の HTTP サーバーを手元で動かします。外部のアプリはどんなベアラー トークンでもこのプロキシを指すことができ、プロキシが送り出すときに本物の OAuth の認証情報を付けます。ひととおりの説明は サブスクリプション プロキシ にあります。

hermes security

hermes security <subcommand>

OSV.dev に照らして脆弱性をその場で調べます。Hermes の仮想環境（入っている PyPI の配布物）、~/.hermes/plugins/ の下のプラグインが宣言した Python の依存、config.yaml で固定した npx / uvx の MCP サーバーが対象です。システム全体に入れたパッケージや、エディター・ブラウザーの拡張は対象外です。

audit のオプション:

hermes login / hermes logout *(非推奨)*

hermes auth

同じプロバイダーの中でキーを回すための、認証情報のまとまりを管理します。詳しい説明は 認証情報のまとまり にあります。

hermes auth                                              # Interactive wizard
hermes auth list                                         # Show all pools
hermes auth list openrouter                              # Show specific provider
hermes auth add openrouter --api-key sk-or-v1-xxx        # Add API key
hermes auth add anthropic --type oauth                   # Add OAuth credential
hermes auth remove openrouter 2                          # Remove by index
hermes auth reset openrouter                             # Clear cooldowns
hermes auth status anthropic                             # Show auth status for a provider
hermes auth logout anthropic                             # Log out and clear stored auth state
hermes auth spotify                                      # Authenticate Hermes with Spotify via PKCE

サブコマンドは add、list、remove、reset、status、logout、spotify です。サブコマンドなしで実行すると、対話的な管理のウィザードが立ち上がります。

hermes status

hermes status [--all] [--deep]

hermes cron

hermes cron <list|create|edit|pause|resume|run|remove|status|tick>

cron のきっかけは cron.provider の設定キーで差し替えられます。空 （既定）なら、プロセスに内蔵された時計を使います。chronos（規模を 0 まで落とせる ホスト型ゲートウェイ向けの NAS 管理の提供元）にすると、cron.chronos.* のキー （portal_url、callback_url、expected_audience、nas_jwks_url）で設定します。 あるいは plugins/cron/<name>/ や $HERMES_HOME/plugins/<name>/ に置いた独自の 提供元の名前を書きます。分からない提供元や使えない提供元を指定した場合は内蔵のものに 戻るので、cron がきっかけを失うことはありません。 cron の内部 も参照してください。

hermes kanban

hermes kanban [--board <slug>] <action> [options]

複数プロファイル・複数プロジェクトの共同作業ボードです。1 つの導入でいくつものボードを持てます（プロジェクト、リポジトリ、領域ごとに 1 つ）。それぞれのボードは、自分の SQLite のデータベースとディスパッチャーの担当範囲を持つ独立した待ち行列です。新しく導入すると default という 1 つのボードから始まり、そのデータベースは以前との互換のため ~/.hermes/kanban.db になります。追加のボードは ~/.hermes/kanban/boards/<slug>/kanban.db に置かれます。ゲートウェイに組み込まれたディスパッチャーは、1 回の巡回ですべてのボードを見ます。

全体に効くオプション（以下のすべての操作に適用されます）:

これは人が使う・スクリプトから使うための入口です。 ディスパッチャーが起こすエージェントのワーカーは、hermes kanban をシェルから呼ぶのではなく、専用の kanban_* ツールセット（kanban_show、kanban_complete、kanban_request_review、kanban_request_changes、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat。取りまとめ役のプロファイルには kanban_list と kanban_unblock も付きます）でボードを動かします。ワーカーの環境には HERMES_KANBAN_BOARD が固定されているので、仕組みのうえでほかのボードを見られません。

例:

# Create a second board and put a task on it without switching away.
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# Switch the active board for subsequent calls.
hermes kanban boards switch atm10-server
hermes kanban list                  # shows atm10-server tasks

# Archive a board (recoverable) or hard-delete it.
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

ボードの決まり方は、強いものから順に --board <slug> → HERMES_KANBAN_BOARD 環境変数 → ~/.hermes/kanban/current のファイル → default です。

すべての操作は、ゲートウェイのスラッシュコマンド（/kanban …）としても同じ引数で使えます。boards のサブコマンドや --board も含みます。

設計の全体（Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise との比較、8 つの共同作業の型、4 つの利用場面、同時実行の正しさの証明）は、リポジトリの docs/hermes-kanban-v1-spec.pdf か かんばんの利用ガイド にあります。

hermes egress

離れた場所のターミナルのサンドボックス向けに、送信時に認証情報を差し込むファイアウォールです。iron-proxy のデーモンを包んでいます。これは TLS を解いて中継するプロキシで、ネットワークの境目で意味を持たないプロキシ用のトークンを本物の上流の API の認証情報に差し替えるため、サンドボックスは本物のキーを持ちません。既定では無効です。設定と仕組みは 送信プロキシ のページを参照してください。

hermes egress install                  # download the pinned iron-proxy binary
hermes egress install --force          # re-download even if already installed

hermes egress setup                    # interactive wizard: CA, mappings, config
hermes egress setup --tunnel-port N    # override the tunnel listener port (default 9090)
hermes egress setup --from-bitwarden   # use Bitwarden Secrets Manager as credential source
hermes egress setup --no-bitwarden     # explicitly switch back to env-based credentials
hermes egress setup --rotate-tokens    # mint fresh proxy tokens (default preserves existing)

hermes egress start                    # spawn the managed proxy daemon
hermes egress stop                     # SIGTERM (then SIGKILL after 5s grace)
hermes egress restart                  # stop (if running) then start — needed for secret changes
hermes egress reload                   # hot-reload the ruleset in-place (no restart, no dropped
                                       #   connections) via the loopback management API

hermes egress status                   # binary + config + pid + listening + mappings
hermes egress status --show-tokens     # print proxy tokens in full (default: redacted)

hermes egress disable                  # flip proxy.enabled = false (does not stop a running proxy)
hermes egress config                   # print the path to proxy.yaml for inspection

よくある流れ

# First-time setup
export OPENROUTER_API_KEY=…
hermes egress setup && hermes egress start
hermes config set terminal.backend docker   # if not already

# Switching credential source after the fact
hermes egress setup --from-bitwarden       # env → bitwarden
hermes egress setup --no-bitwarden         # bitwarden → env
# (just `setup` without either flag preserves the existing mode)

# Rotating all tokens (e.g. after a suspected token leak)
hermes egress setup --rotate-tokens    # setup offers to restart the running daemon for you
# (running sandboxes still hold old tokens; restart them too)

# Adding a new upstream
# Edit ~/.hermes/config.yaml proxy.extra_allowed_hosts: [api.example.com]
hermes egress setup
hermes egress restart                  # one-command apply (stop + start)

調べるときの近道

hermes egress status                     # current state in one view
cat ~/.hermes/proxy/proxy.yaml           # the rendered iron-proxy config
tail -20 ~/.hermes/proxy/iron-proxy.log  # daemon-level diagnostics
tail -f ~/.hermes/proxy/iron-proxy.log | jq  # daemon + per-request log (line-delimited JSON; v0.39 combines both streams)

よくある失敗と立て直し方は 送信プロキシ → 困ったときは にまとめてあります。

hermes project

hermes project <create|list|show|add-folder|remove-folder|rename|set-primary|use|archive|restore|bind-board>

プロジェクトは、複数のフォルダーやリポジトリにまたがれる、人が名前を付けたワークスペースです。デスクトップでのセッションのまとまりの土台になり、かんばんのボードと結び付けると、作業に決まった形のワークツリーとブランチが割り当てられます。状態はプロファイルごとに持ちます。

hermes webhook

hermes webhook <subscribe|list|remove|test>

出来事をきっかけにエージェントを動かすための、動的な webhook の登録を管理します。設定で webhook のプラットフォームを有効にしておく必要があります。設定していない場合は、その手順が表示されます。

hermes webhook subscribe

hermes webhook subscribe <name> [options]

登録の内容は ~/.hermes/webhook_subscriptions.json に残り、ゲートウェイを再起動しなくても webhook のアダプターがその場で読み直します。

hermes doctor

hermes doctor [--fix]

hermes dump

hermes dump [--show-keys]

Hermes の設定の全体を、短い素の文字でまとめて出します。困ったときに Discord、GitHub の issue、Telegram へそのまま貼り付けられるように作られていて、色も飾りもなく、中身だけが並びます。

何が入るか

出力の例

--- hermes dump ---
version:          0.8.0 (2026.4.8) [af4abd2f]
os:               Linux 6.14.0-37-generic x86_64
python:           3.11.14
openai_sdk:       2.24.0
profile:          default
hermes_home:      ~/.hermes
model:            anthropic/claude-opus-4.6
provider:         openrouter
terminal:         local

api_keys:
  openrouter           set
  openai               not set
  anthropic            set
  nous                 not set
  firecrawl            set
  ...

features:
  toolsets:           all
  mcp_servers:        0
  memory_provider:    built-in
  gateway:            running (systemd)
  platforms:          telegram, discord
  cron_jobs:          3 active / 5 total
  skills:             42

config_overrides:
  agent.max_turns: 250
  compression.threshold: 0.85
  display.streaming: True
--- end dump ---

使いどころ

• GitHub に不具合を報告するとき — issue にそのまま貼り付ける
• Discord で助けを求めるとき — コード ブロックに入れて共有する
• 自分の環境を誰かのものと見比べるとき
• 何かうまくいかないときの手早い確認

hermes debug

hermes debug share [options]

調査用の報告（システム情報と直近のログ）を貼り付けサービスに送り、共有できる URL を受け取ります。手早く助けを求めたいときに便利で、助ける側が原因を探るのに必要なものがひととおり入っています。

報告には、システム情報（OS、Python の版、Hermes の版）、直近のエージェント・ゲートウェイ・GUI とダッシュボード・デスクトップのログ（1 ファイルあたり 512 KB まで）、そして伏せ字にした API キーの状況が入ります。既定では伏せて送られるので、秘密の情報は含まれません。

既定の送信先は公開の貼り付けサービスで、paste.rs、dpaste.com の順に試します。--nous を付けると、同じ一式を非公開の Nous の診断用の保管先へ送ります。返ってくる閲覧用のリンクは Nous のチーム向けで、14 日後に自動で消えます。

例

hermes debug share              # Upload debug report, print URL
hermes debug share --lines 500  # Include more log lines
hermes debug share --expire 30  # Keep paste for 30 days
hermes debug share --nous       # Upload a private diagnostics bundle for Nous support
hermes debug share --local      # Print report to terminal (no upload)

hermes backup

hermes backup [options]

Hermes の設定、スキル、セッション、データを zip にまとめます。hermes-agent のコードそのものは含まず、以前のバックアップの成果物（backups/、state-snapshots/）を入れ子にすることもありません。それらはすでに自分の state.db の写しを持っているからです。

バックアップは SQLite の backup() API で安全に写すので、Hermes が動いている最中でも正しく取れます（WAL モードでも安全です）。

zip に入らないもの:

• *.db-wal、*.db-shm、*.db-journal — SQLite の WAL・共有メモリ・ジャーナルの付属ファイル。*.db は sqlite3.backup() で一貫したスナップショットになっているので、動いている付属ファイルを一緒に入れると、復元したときに中途半端な状態が見えてしまいます。
• checkpoints/ — セッションごとの経過のキャッシュ。ハッシュで鍵付けされていてセッションごとに作り直されるので、どのみち別の導入先へ持っていっても使えません。
• hermes-agent のコード自体（これは利用者のデータのバックアップであって、リポジトリのスナップショットではありません）。

例

hermes backup                           # Full backup to ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # Full backup to specific path
hermes backup --quick                   # Quick state-only snapshot
hermes backup --quick --label "pre-upgrade"  # Quick snapshot with label

hermes checkpoints

hermes checkpoints [COMMAND]

~/.hermes/checkpoints/ にある裏の git の保管場所を確認・管理します。セッション中の /rollback を支えている保管の層です。いつ実行しても安全で、エージェントが動いている必要もありません。

オプション

例

hermes checkpoints                                  # status overview
hermes checkpoints prune --retention-days 3         # aggressive cleanup
hermes checkpoints prune --max-size-mb 200          # tighten size cap once
hermes checkpoints clear-legacy -f                  # drop v1 archive dirs
hermes checkpoints clear -f                         # wipe everything

仕組みの全体とセッション中のコマンドは チェックポイントと /rollback を参照してください。

hermes import

hermes import <zipfile> [options]

前に作った Hermes のバックアップを、Hermes のホーム ディレクトリに戻します。書庫の中のファイルはすべて既存のファイルを上書きします。--force は、すでに Hermes が入っているときに出る確認を省くだけです。

例

hermes import ~/hermes-backup-20260423.zip           # Prompts before overwriting existing config
hermes import ~/hermes-backup-20260423.zip --force   # Overwrite without prompting

hermes logs

hermes logs [log_name] [options]

Hermes のログを見る・追う・絞り込みます。ログはすべて ~/.hermes/logs/（既定以外のプロファイルなら <profile>/logs/）にあります。

ログ ファイル

オプション

例

# View the last 50 lines of agent.log (default)
hermes logs

# Follow agent.log in real time
hermes logs -f

# View the last 100 lines of gateway.log
hermes logs gateway -n 100

# Show only warnings and errors from the last hour
hermes logs --level WARNING --since 1h

# Filter by a specific session
hermes logs --session abc123

# Follow errors.log, starting from 30 minutes ago
hermes logs errors --since 30m -f

# List all log files with their sizes
hermes logs list

絞り込み

絞り込みは組み合わせられます。複数を指定したときは、すべてを満たす行だけが表示されます。

# WARNING+ lines from the last 2 hours containing session "tg-12345"
hermes logs --level WARNING --since 2h --session tg-12345

時刻を読み取れない行は、--since を使っているときも表示されます（複数行のログの続きであることがあるためです）。水準を判別できない行も、--level を使っているときに表示されます。

ログの入れ替え

Hermes は Python の RotatingFileHandler を使います。古いログは自動で入れ替わるので、agent.log.1、agent.log.2 なども探してみてください。hermes logs list は、入れ替わったものも含めてすべてのログ ファイルを表示します。

hermes prompt-size

hermes prompt-size [--platform <name>] [--json]

新しいセッションで固定的にかかるプロンプトの量、つまり会話の中身が乗る*前*に 毎回の API 呼び出しで送られるものを報告します。下流のアダプターや プロキシがモデルの文脈の窓より狭いときや、どのかたまり（スキルの索引、記憶、 利用者像）が場所を取っているかを見たいときに役立ちます。

エージェントが使うのと同じシステム プロンプトを組み立て、内訳を出します。

• システム プロンプトの合計 — 組み上がったプロンプト全体（身元、案内、スキルの

索引、文脈のファイル、記憶、利用者像、時刻）。

• スキルの索引 — <available_skills> のかたまり。スキルをたくさん入れていると、

ここがいちばん大きくなりがちです。

• 記憶と利用者像 — MEMORY.md と USER.md の写し。
• プロンプトの段 — stable / context / volatile。Hermes がキャッシュを効かせるために

プロンプトを重ねている順そのものです。

• ツールのスキーマ — 有効なすべてのツールの JSON（毎回かかる固定分の

もう半分です）。

すべてネットにつながずに動きます。API も呼ばず、認証情報がなくても使えます。

# Human-readable breakdown for the CLI platform (default)
hermes prompt-size

# Simulate a messaging platform's prompt (different platform hint)
hermes prompt-size --platform telegram

# Machine-readable output for scripts
hermes prompt-size --json

hermes config

hermes config <subcommand>

サブコマンド:

hermes pairing

hermes pairing <list|approve|revoke|clear-pending>

hermes skills

hermes skills <subcommand>

サブコマンド:

よく使う例:

hermes skills browse
hermes skills browse --source official
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect official/security/1password
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install official/migration/openclaw-migration
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills install https://sharethis.chat/SKILL.md                     # Direct URL (+ referenced support files)
hermes skills install https://example.com/SKILL.md --name my-skill        # Override name when frontmatter has none
hermes skills check
hermes skills update
hermes skills config
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes
hermes skills opt-out                  # stop future bundled-skill seeding (nothing deleted)
hermes skills opt-out --remove --yes   # also delete UNMODIFIED bundled skills
hermes skills opt-in --sync            # undo: remove marker and re-seed now

補足:

• --force は、他社やコミュニティのスキルについて、危険でない方針上の制限を押し切れます。
• --force でも dangerous という検査結果は押し切れません。
• --source skills-sh は公開されている skills.sh の一覧を検索します。
• --source well-known を使うと、/.well-known/skills/index.json を公開しているサイトを Hermes に見に行かせられます。
• --source browse-sh は browse.sh の、サイトごとのブラウザー自動操作のスキル 200 件以上のカタログを検索します。識別子は browse-sh/airbnb.com/search-listings-ddgioa のような形です。
• http(s)://…/*.md の URL を渡すと、SKILL.md に加えて、その中ではっきり参照されている references/、templates/、scripts/、assets/、examples/ の下のファイルも入ります。冒頭の情報に name: がなく、URL の末尾も名前として使えないときは、対話的な端末なら名前を尋ねます。対話できない場所（TUI の中の /skills install、メッセージング プラットフォーム）では代わりに --name <x> が必要です。

hermes bundles

hermes bundles <subcommand>

スキル束は、複数のスキルを 1 つの /<bundle-name> スラッシュコマンドにまとめるものです。束を呼ぶと、参照しているすべてのスキルが 1 つのメッセージにまとめて読み込まれます。保存先は ~/.hermes/skill-bundles/<slug>.yaml です。YAML の書き方と動きは スキル束 を参照してください。

サブコマンド:

例:

hermes bundles create backend-dev \
  --skill github-code-review \
  --skill test-driven-development \
  --skill github-pr-workflow \
  -d "Backend feature work"

hermes bundles list
hermes bundles show backend-dev
hermes bundles delete backend-dev

チャットのセッションでは、/bundles で導入済みの束を一覧し、/<bundle-name> で 1 つ読み込みます。

hermes curator

hermes curator <subcommand>

キュレーターは、補助のモデルがバックグラウンドで動く仕組みです。エージェントが作ったスキルを定期的に見直し、古くなったものを整理し、重なっているものをまとめ、要らなくなったものを保管します。同梱のスキルとハブから入れたスキルには決して触れません。保管したものは元に戻せて、自動で削除されることはありません。

新しく導入した直後は、最初の定期実行が interval_hours 1 回分（既定では 7 日）だけ後ろにずれます。hermes update のあとの最初の巡回で、ゲートウェイがすぐに手入れを始めることはありません。それより前に様子を見たいときは hermes curator run --dry-run を使ってください。

動きと設定は キュレーター を参照してください。

hermes moa

名前を付けた Mixture of Agents のプリセットを設定します。プリセットは、どのモデル選択画面でも Mixture of Agents というプロバイダーの下に選べるモデルとして出てきます。/moa <prompt> は、既定のプリセットでプロンプトを 1 つ処理します。

hermes moa list
hermes moa configure [name]
hermes moa delete <name>

hermes moa configure は、参照するモデルと取りまとめ役のそれぞれについて、Hermes のプロバイダー → モデルの選択画面を使い回します。プリセットは動かし方の設定であって、主となるモデルやプロバイダーではありません。

hermes fallback

hermes fallback <subcommand>

代替のプロバイダーの連なりを管理します。主なモデルが回数制限、過負荷、接続のエラーで失敗したとき、代替のプロバイダーが順に試されます。

代替のプロバイダー も参照してください。

hermes hooks

hermes hooks <subcommand>

~/.hermes/config.yaml に書いたシェル スクリプトのフックを確認し、作った入力で試し、~/.hermes/shell-hooks-allowlist.json にある初回の同意の許可リストを管理します。

出来事の種類と受け取る内容の形は フック を参照してください。

hermes memory

hermes memory <subcommand>

外部の記憶の提供元のプラグインを用意し、管理します。使える提供元は honcho、openviking、mem0、hindsight、holographic、retaindb、byterover、supermemory です。外部の提供元は一度に 1 つだけ有効にできます。組み込みの記憶（MEMORY.md と USER.md）はつねに動いています。

サブコマンド:

hermes acp

hermes acp

エディター連携のために、Hermes を ACP（Agent Client Protocol）の標準入出力のサーバーとして起動します。

関連する入口:

hermes-acp
python -m acp_adapter

先に対応する部品を入れてください。

cd ~/.hermes/hermes-agent && uv pip install -e '.[acp]'

ACP によるエディター連携 と ACP の内部 を参照してください。

hermes mcp

hermes mcp <subcommand>

MCP（Model Context Protocol）のサーバーの設定を管理し、Hermes を MCP のサーバーとして動かします。

MCP の設定の早見表、Hermes で MCP を使う、MCP サーバー モード を参照してください。

hermes plugins

hermes plugins [subcommand]

プラグインをまとめて管理します。一般のプラグイン、記憶の提供元、文脈のエンジンを 1 か所で扱えます。サブコマンドなしで hermes plugins を実行すると、2 つの節を持つ対話画面が開きます。

• General Plugins — 導入済みのプラグインを、チェックボックスで有効・無効にします
• Provider Plugins — 記憶の提供元と文脈のエンジンを 1 つずつ選びます。分類の上で ENTER を押すと選択肢が開きます。

提供元のプラグインの選択は config.yaml に保存されます。

• memory.provider — 有効な記憶の提供元（空なら組み込みだけ）
• context.engine — 有効な文脈のエンジン（"compressor" が組み込みの既定）

一般のプラグインの無効一覧は、config.yaml の plugins.disabled に入ります。 git から入れたものについては、正式な入手元、実際に入った版、固定の有無だけを プロファイルごとの plugins/.install-metadata.json に記録します。ここに プラグインの設定、環境の値、秘密、与えた権限は入りません。

プラグイン と Hermes のプラグインを作る を参照してください。

hermes tools

hermes tools [--summary]

--summary を付けなければ、プラットフォームごとにツールを設定する対話画面が開きます。

hermes computer-use

hermes computer-use <subcommand>

サブコマンド:

hermes computer-use install は、computer_use のツールセットが使う cua-driver の実行ファイルを入れるための、 安定した入口です。Computer Use を初めて有効にしたときに hermes tools が呼ぶ のと同じ提供元のインストーラーを実行するので、ツールセットの切り替えで うまく走らなかったとき（たとえば、すでに設定済みの人が実行したとき）に、 入れ直しの手段として安心して使えます。

cua-driver がすでにあるときは、Hermes がその版と実行時のマニフェストを確認します。 0.20.0 以降の使える導入はそのまま残します。古かったり足りなかったりする標準の導入は、 いまの提供元のインストーラーで直します。HERMES_CUA_DRIVER_CMD で選んだ独自の 実行ファイルを Hermes が置き換えることはありません。その実行ファイルを自分で更新するか、 上書きの設定を外してください。直す必要があるかどうかは hermes computer-use status が報告します。

Hermes との連携としておすすめなのは、組み込みの computer_use のツールセットです。 Cua の生の MCP ツールを登録するのは、Cua の低い水準の道具立てが必要なときの 代わりの手です。cua-driver skills install は Hermes を見つけて、Cua の スキル一式を Hermes のスキルのディレクトリへ自動でつなぎます。

権限の扱い方、権限のマニフェストの承認、既存のプロファイルへの許可は、実行時の 起動に属します。範囲を絞ったモードでは、Hermes が Cua の正式な --capability-manifest と --approve-capability-manifest を渡します。どの MCP の 経路も、自分の実行環境の中に専用の生存期間のセッションを持ちます。公開のセッション名は カーソルとセッションの状態を示す札で、実行環境を持つわけでも共有するわけでもありません。

cua-driver が PATH にあれば、hermes update は更新の最後に提供元の インストーラーを自動で走らせ直すので、たいていの人が自分で --upgrade を 使う必要はありません。次の Hermes の更新を待たずに、提供元の修正を いますぐ取り込みたいときに使ってください。

hermes pets

hermes pets <list|install|select|show|off|scale|remove|doctor>

Petdex は、コーディングのエージェント向けに動くドット絵のペットを集めた公開の展示場です。1 匹入れると、CLI、TUI、デスクトップ アプリで、エージェントの動きに反応する様子が見られます。

/hatch スラッシュコマンドを使えば、文章での説明からまったく新しいペットを作れます。ペット を参照してください。

hermes sessions

hermes sessions <subcommand>

サブコマンド:

hermes insights

hermes insights [--days N] [--source platform]

hermes claw

hermes claw migrate [options]

OpenClaw の設定を Hermes へ移します。~/.openclaw（または指定したパス）から読み、~/.hermes へ書きます。古いディレクトリ名（~/.clawdbot、~/.moltbot）や設定ファイル名（clawdbot.json、moltbot.json）も自動で見つけます。

何が移るか

移行の対象は、人格、記憶、スキル、モデルのプロバイダー、メッセージング プラットフォーム、エージェントの振る舞い、セッションの方針、MCP サーバー、読み上げなど 30 を超える分類にわたります。それぞれは、Hermes の同等のものへそのまま取り込まれるか、あとで自分で見直すために保管されるかのどちらかです。

そのまま取り込まれるもの: SOUL.md、MEMORY.md、USER.md、AGENTS.md、スキル（4 つの元ディレクトリ）、既定のモデル、独自のプロバイダー、MCP サーバー、メッセージング プラットフォームのトークンと許可リスト（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、エージェントの既定値（推論の深さ、圧縮、人らしい間、タイムゾーン、サンドボックス）、セッションの作り直しの方針、承認の規則、読み上げの設定、ブラウザーの設定、ツールの設定、実行の制限時間、コマンドの許可リスト、ゲートウェイの設定、3 つの出どころからの API キー。

あとで見直すために保管されるもの: cron の作業、プラグイン、フックと webhook、記憶のバックエンド（QMD）、スキルのレジストリの設定、画面と身元、ログ、複数エージェントの構成、チャンネルの結び付け、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。

API キーの解決は 3 つの出どころを優先度の順に見ます。設定の値 → ~/.openclaw/.env → auth-profiles.json。トークンの項目はすべて、素の文字列、環境変数のひな形（${VAR}）、SecretRef のオブジェクトのいずれにも対応します。

設定キーの完全な対応表、SecretRef の扱いの詳細、移行後の確認事項は、移行ガイドの全体 を参照してください。

例

# Preview what would be migrated
hermes claw migrate --dry-run

# Full migration (all compatible settings, no secrets)
hermes claw migrate --preset full

# Full migration including API keys
hermes claw migrate --preset full --migrate-secrets

# Migrate user data only (no secrets), overwrite conflicts
hermes claw migrate --preset user-data --overwrite

# Migrate from a custom OpenClaw path
hermes claw migrate --source /home/user/old-openclaw

hermes import-agent

hermes import-agent [claude-code|codex] [options]

Claude Code（~/.claude）や OpenAI Codex CLI（~/.codex）の設定を Hermes へ取り込みます。CLAUDE.md と AGENTS.md の指示は記憶の項目へ、Bash(...) の許可・拒否の規則は command_allowlist と approvals.deny へ、MCP サーバーは config.yaml の mcp_servers へ、スキルのディレクトリは ~/.hermes/skills/ へ移します。適用の前に必ず下見が出ます。API キーと認証情報は決して取り込みません。

対応表の全体は 取り込みガイド を参照してください。

hermes serve

hermes serve [options]

Hermes のバックエンド サーバーを起動します。デスクトップ アプリ や離れた場所のクライアントがつなぐ、JSON-RPC と WebSocket の窓口です。hermes dashboard が動かすのと同じサーバーですが、画面がありません。ブラウザーの UI を開くことは決してありません。デスクトップ アプリは自分で hermes serve のバックエンドを立ち上げます。離れた場所のホストに画面なしのバックエンドを置きたいときは、このコマンドを直接使ってください。下の hermes dashboard と同じ --host / --port / --insecure / --skip-build / --stop / --status を受け付けます（ループバック以外に結び付けると、同じ認証の関門が働きます）。[web] の追加部品が必要で、組み込みのチャットの接続には POSIX のホストで [pty] も要ります。

ポートがぶつかったとき: 指定したポート（既定は 9119）を別のプロセス（2 つ目の hermes serve やゲートウェイなど）が使っている場合、機械が読める目印の行 BACKEND_PORT_IN_USE port=<port> を標準出力に出し、掴んでいそうな相手を人向けに知らせ、ありきたりのエラーではなく終了コード 75（EX_TEMPFAIL）で終わります。スクリプトやデスクトップ アプリが「ポートがふさがっている」と「バックエンドが壊れている」を区別できるようにするためです。--port 0 を渡すと、空いているポートを自動で使います（起動に成功すると、選んだポートを HERMES_BACKEND_READY port=<port> で知らせます）。

hermes dashboard

hermes dashboard [options]

ウェブ ダッシュボードを起動します。設定や API キーの管理、セッションの様子を見るための、ブラウザーで使う画面です。（デスクトップ アプリが立ち上げるような、ブラウザーの画面を持たないバックエンドがほしいときは、上の hermes serve を使ってください。）cd ~/.hermes/hermes-agent && uv pip install -e ".[web]"（FastAPI と Uvicorn）が必要です。組み込みのブラウザーのチャットのタブはいつでも使えますが、pty の追加部品（cd ~/.hermes/hermes-agent && uv pip install -e ".[web,pty]"）と、Linux、macOS、WSL2 のような POSIX の PTY の環境も必要です。詳しい説明は ウェブ ダッシュボード にあります。

hermes dashboard register

この導入を、自前で立てたダッシュボードとして Nous Portal のアカウントに登録します。OAuth のクライアントを作り、HERMES_DASHBOARD_OAUTH_CLIENT_ID を ~/.hermes/.env に書き、ログインの関門を有効にする方法を表示します。あらかじめログインしておく必要があります（hermes setup）。

# Default — opens browser to http://127.0.0.1:9119
hermes dashboard

# Custom port, no browser
hermes dashboard --port 8080 --no-open

# From a profile alias — routes to the machine dashboard with the
# profile preselected in the sidebar switcher (attach if running)
worker dashboard

hermes profile

hermes profile <subcommand>

プロファイル（設定、セッション、スキル、ホーム ディレクトリをそれぞれ別に持つ、互いに独立した複数の Hermes）を管理します。

例:

hermes profile list
hermes profile create work --clone
hermes profile use work
hermes profile alias work --name h-work
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes profile install github.com/user/my-distro --alias
hermes profile update work
hermes -p work chat -q "Hello from work profile"

hermes completion

hermes completion [bash|zsh|fish]

シェルの補完スクリプトを標準出力に出します。シェルの設定でこの出力を読み込めば、Hermes のコマンド、サブコマンド、プロファイル名を Tab キーで補完できます。

例:

# Bash
hermes completion bash >> ~/.bashrc

# Zsh
hermes completion zsh >> ~/.zshrc

# Fish
hermes completion fish > ~/.config/fish/completions/hermes.fish

hermes update

hermes update [--gateway] [--check] [--plan] [--no-backup] [--backup] [--yes]

hermes-agent の最新のコードを取得し、管理下の仮想環境に依存関係を入れ直したうえで、導入後の処理（MCP サーバー、スキルの同期、補完の導入）をやり直します。動いている環境でも安全に実行できます。導入せずに、自分の手元が origin/main より遅れているかを見たいときは --check を使ってください。

hermes update は設定された更新用のブランチ（既定: main）を取得します。別のブランチにいる場合、Hermes が取得の前に更新用のブランチへ切り替えることがあります。ブランチでの作業を更新時の自動退避の流れの外に置いておきたいときは、更新の前にコミットしてください。

そのほかの動き:

• ゲートウェイの再起動。 更新に成功すると、新しいコードを使うために、Hermes は動いているすべてのゲートウェイのプロファイルを自動で再起動しようとします。更新せずにゲートウェイだけ再起動したいときは hermes gateway restart を使ってください。
• 再起動の段の立て直し。 取得したばかりのツリーを読み込む途中で再起動の段が止まった場合、監視下のゲートウェイのプロファイルはきれいな Python のプロセスでやり直されます。systemd（systemctl --user is-active）が独立に確かめた再起動だけが「確認済み」として報告され、単に 0 で終わっただけの立て直しは relaunch_attempted として記録され、更新は安全側に倒して失敗になります。手動で動かしているゲートウェイや serve / dashboard の実行は、立て直す権限がない限り決して止めません。理由つきで飛ばしたと記録され、正確な再起動のコマンドとともに未完了の報告に残ります。
• 更新の控えと全台の版の確認。 実行のたびに、機械が読める控えが ~/.hermes/logs/update_receipts/ に書かれます（更新前の全体の計画、手順、飛ばした理由、再起動の結果。latest.json がいちばん新しいものを指します）。再起動の段のあと、動いている各ゲートウェイのコードを更新後のツリーと突き合わせ、プロファイルごとの版の表を出します。更新前のコードのままのゲートウェイがあれば、正確な再起動のコマンドとともに更新は失敗（終了コード 1）になります。
• 手元のソースの変更。 git での導入では、追跡しているファイルの変更と追跡していないファイルが、ブランチの切り替えや取得の前に自動で退避されます（git stash push --include-untracked）。対話的な端末での更新では、戻すかどうかを尋ねます。対話がない更新では既定で戻します。取得に成功したあと手元のソースの変更を捨ててよい管理下の導入でだけ、updates.non_interactive_local_changes: discard を設定してください。戻すときにぶつかった場合や取得に失敗した場合は、手で回収できるよう退避したまま残します。
• npm のロック ファイルの揺れ。 退避やブランチの切り替えの前に、Hermes は npm の導入・組み立てで生じた package-lock.json の差分をできる範囲で片付けます。意図して変えたロック ファイルは、hermes update の前にコミットするか自分で退避してください。
• 紐づけ情報のスナップショット。 --backup を付けていなくても、hermes update は git pull の前に ~/.hermes/pairing/ と Feishu のコメントの規則の軽いスナップショットを取ります。編集中のファイルが取得で書き換わってしまったときは、hermes backup restore --state pre-update で戻せます。
• 古い hermes.service の注意。 名前を変える前の hermes.service の systemd のユニット（いまの hermes-gateway.service ではないもの）を見つけると、行き来を繰り返す問題を避けるために移行の案内を一度だけ表示します。
• 終了コード。 成功なら 0、取得・導入・導入後の処理のエラーなら 1、git pull を妨げる予期しない作業ツリーの変更があれば 2 です。

保守のコマンド

| hermes uninstall [--full] [--gui] [--dry-run] [--yes] | Hermes を取り除きます。必要なら設定とデータもすべて消します。--gui はデスクトップのチャットの画面だけを取り除き、エージェントはそのまま残します。--full は設定とデータも消します。--dry-run は何も変えずに、消される対象を表示します。--yes は確認を省きます。 |

関連ページ

• スラッシュコマンド早見表
• CLI の使い方
• セッション
• スキルの仕組み
• スキンとテーマ