Hermes Agentでインタラクティブなチャットを起動するデフォルトのやり方は何ですか？

インストール後、シェルから hermes または hermes chat を実行してください。設定済みのデフォルトモデル、ツールセット、プロファイルとともに、対話型エージェントが開きます。

スクリプト用に、最終的な回答のみを出力するワンショットを実行するには、どのようにすればよいですか？

hermes -z を使用すると、標準出力に最終テキストのみが表示されます。ターミナルで hermes chat -q を実行すると対話セッションが開始されるようになりました。プロセスが1回の回答後に終了する必要がある場合は、–oneshot を追加する、-Q を指定する、または非TTYの標準入出力で実行してください。そのトランスクリプト内のツール出力には、hermes chat –oneshot -q を使用します。

ターミナル上のHermesモデルと、セッション内のスラッシュモデルコマンドは、どのような違いがありますか？

Hermesモデルはチャットセッションの外で動作し、プロバイダーの追加、APIキーの設定、OAuthログイン、カスタムエンドポイントの設定を行うことができます。スラッシュコマンド /model は、すでに設定済みのプロバイダー間での切り替えのみを行います。

Hermes Agentは、設定情報やシークレット（機密情報）をディスク上のどこに保存していますか？

ステートは通常HERMES_HOME（~/.hermes）以下に格納され、設定用のconfig.yaml、シークレット用の.env、必要に応じての認証データ、およびセッション、スキル、メモリ、cron、ログのフォルダが含まれます。

モデルが失敗した場合やAPIキーが正しくない可能性がある場合、どのCLIコマンドが役立つのですか？

修正には hermes doctor 、スナップショットには hermes status 、貼り付けやすい要約には hermes dump 、そしてフィルタやフォロームードを用いた hermes logs で失敗を検査してください。

WSL2上でメッセンジゲートウェイをどのように実行すればよいですか？

systemdのバックグラウンド起動に依存するのではなく、WSLにおけるsystemdの動作にばらつきがあるため、tmux内でhermes gatewayを実行する方式を推奨します。まず、hermes gateway setupでプラットフォームを設定してください。

1台のマシン上で、複数の相互に影響し合わないHermes環境をどのように実行しますか？

hermesプロファイルを使用して個別のホームを作成し、–profileオプションやhermes profile useコマンドで切り替えます。これにより、各プロファイルが独自の設定、セッション、スキル、ゲートウェイ状態を保持します。

Hermes Agent CLI 早見表 — コマンド、フラグ、スラッシュショートカット

セルフホストされたHermes Agent用シェルおよびTUIコマンド。

Nous Research が提供する Hermes Agent は、モデル非依存型でツール利用可能なアシスタントであり、ローカルまたは VPS で実行し、シェル、全画面表示の TUI、メッセージングゲートウェイのいずれからでも利用できます。

Hermes は特定的一个インタフェースに固定しません。利用可能な手段は以下の通りです。

従来の hermes / hermes chat CLI、
全画面表示の hermes --tui セッション、
Telegram、Discord、Slack など他のメッセージングプラットフォーム向けに長時間稼働する hermes gateway、
Web 追加機能がインストールされている場合の、ローカルブラウザ用 UI である hermes dashboard。

これらの経路は、~/.hermes 配下で同じ設定とデータを共有しています。このページでは、それらのモード全体で重要となるシェルコマンドをリストアップしています。

Hermes Agent CLI チートシート — ターミナルリファレンス

以下は、タスク別にグループ化された高密度のコマンドリファレンスです。2026年10月6日時点で公式 CLI コマンドリファレンスと照合済みです。その時点での最新の安定版タグは v0.21.5 (v2026.9.24) です。

Hermes Agent のインストールと初回実行時の CLI コマンド

インストールとトラブルシューティングについては、まず Hermes AI アシスタント — インストール、セットアップ、ワークフロー、トラブルシューティングから始めてください。

インストーラーはリポジトリを取得し、Python 環境を設定して hermes 実行ファイルをセットアップします。source ~/.bashrc または ~/.zshrc を実行した後、対話型チャットのデフォルトのエントリポイントは単純に hermes です（hermes chat と同じ系譜）。

コマンド	説明
`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \| bash`	公式のワンライナーインストール（Linux、macOS、WSL2）。
`hermes` / `hermes chat`	インストール後の対話型チャットの開始（デフォルトの日常エントリ）。
`hermes --version` / `hermes version`	バージョン情報の表示。
`hermes completion bash` \| `zsh` \| `fish`	タブ補完用のシェル補完スクリプトを出力。
`hermes update [--check] [--backup] [--restart-gateway]`	最新コードを取得し、依存関係を再インストール。更新前のホームスナップショットまたはゲートウェイ再起動もオプション。
`hermes uninstall [--full] [--yes]`	Hermes の削除。完全なデータ削除もオプション。

ネイティブ Windows はサポートされていません。WSL2 を使用してください。Android での Termux を使ったインストールは、アップストリームのドキュメントに専用パスがあります。

すべての `hermes` 呼び出しに適用されるグローバルフラグ

これらのフラグはサブコマンドの前に適用され、どのプロファイル、どのセッション、またはどれほど個人設定を読み込むかを変更します。

フラグ	説明
`--profile`, `-p`	この実行に使用する Hermes プロファイルを選択（`hermes profile use` のスティッキーデフォルトを上書き）。
`--resume`, `-r`	ID またはタイトルからセッションを再開。
`--continue [name]`, `-c`	最新のセッション、またはタイトルに一致する最新セッションを続行。
`--worktree`, `-w`	並行エージェント用に隔離された Git worktree で開始。
`--yolo`	危険なコマンドの承認プロンプトをバイパス（注意して使用）。
`--pass-session-id`	システムプロンプトにセッション ID を含める。
`--ignore-user-config`	`~/.hermes/config.yaml` をスキップ（デフォルトのみ）。`.env` は引き続きロードされます。
`--ignore-rules`	AGENTS.md、SOUL.md、`.cursorrules`、メモリ、事前ロードスキルなどの自動注入をスキップ。
`--tui`	TUI を起動（`HERMES_TUI=1` に相当）。
`--dev`	`--tui` と組み合わせて使用し、TUI 開発用に `tsx` で TS ソースを実行。

孤立した自動化処理では、hermes chat --ignore-user-config --ignore-rules と hermes -z を組み合わせて再現可能なワンショット実行を行うことがよくあります。

`hermes chat`、ワンショットプロンプト、および `hermes -z`

コマンド / パターン	説明
`hermes chat`	対話型またはスクリプトによるチャット。`-q`、`-m`、`--provider`、ツールセット、再開、worktree、チェックポイントの主なインターフェース。
`hermes chat -q "..."`	TTY 上では、プロンプトを最初のターンとして送信し、セッション内にとどまる。0.21 以前は 1 回の回答後に終了していました。
`hermes chat --oneshot -q "..."`	回答して終了（旧来の `-q` の動作）。`-Q` または非 TTY の stdio により暗黙に指定されます。トランスクリプトにツール出力が必要な場合に使用。
`hermes chat --query-file PATH`	ファイルからプロンプトを読み込む、または stdin を示す `-`。シェル解釈は行われません。`-q` とは排他制御。
`hermes -z "..."`	スクリプトによるワンショット — 標準出力には最終回答のみ、バナーやセッションノイズなし。同じエージェントとツールを使用。パイプやスクリプトに最適。
`hermes -z "…" --usage-file PATH`	`-z` 実行後、JSON 形式の使用量レポート（トークン、コスト、`completed` / `failed` / `partial`）をファイルに書き出す。実行が失敗した場合でも書き出されます。
`hermes chat -q "…" --format stream-json`	標準出力に JSONL イベント（`system`、`text`、`tool_use`、`tool_result`、`result`）。静粛モードを暗黙に有効化。`--tui` は拒否されます。
`hermes chat --quiet`, `-Q`	より静粛なプログラマティックモード（バナーとツールプレビューを抑制）。`-q` と組み合わせると oneshot も暗黙に指定。
`-m` / `--model`, `--provider`	実行毎のモデルとプロバイダーの上書き。環境変数 `HERMES_INFERENCE_MODEL` / `HERMES_INFERENCE_PROVIDER` が同様の動作を反映。
`-t` / `--toolsets`	実行でコンマ区切りのツールセットを有効化。
`-s` / `--skills`	スキルの事前ロード（反復またはコンマ区切り）。
`--image path`	単一のクエリにローカル画像を添付。
`--checkpoints`	破壊的編集前にファイルシステムチェックポイントを有効化。
`--max-turns N`	1 ターンあたりのツール呼び出しイテレーション数を制限（デフォルト 500、または設定の `agent.max_turns`）。
`--safe-mode`	ユーザー設定、ルール、メモリ、プラグイン、シェルフック、MCP を無効化。`--ignore-user-config` と `--ignore-rules` を暗黙に含みます。
`--source`	セッションソースタグ（統合向けに `cli` と `tool`）。ワンショット実行はデフォルトで `oneshot`。

セッション外の hermes model とセッション内の /model — シェルから hermes model を実行することは、プロバイダー、キー、OAuth を追加する場所です。スラッシュ /model はすでに設定済みのプロバイダー間で切り替えるだけです。/model に OpenRouter しか表示されない場合、セッションを終了して hermes model を完了させてください。

終了コード。 chat --oneshot / -Q の実行は、ターンが完了した場合に 0、失敗・途中停止・イテレーション予算に達した場合・開始しなかった場合に 1、割り込み時に 130 で終了します。hermes -z は別のマッピングを使用します：0 完了、2 失敗または部分的（説明を出力しても）、1 完了したターンにテキストがなかった場合、130 割り込み。パイプラインの判定は、標準出力が空かどうかではなく終了コードで行ってください。

モデルピッカー、クレデンシャルプール、フォールバックプロバイダー

コマンド	説明
`hermes model`	対話型プロバイダーとモデルピッカー。キー、OAuth、カスタムエンドポイント。
`hermes auth`	クレデンシャルプール — ロテーション対応キーと OAuth のための `add`、`list`、`remove`、`reset`。
`hermes fallback [list \| add \| remove \| clear]`	主要プロバイダーがエラーまたはレートリミットに達した場合の順序付きフォールバックプロバイダーの管理。
`hermes setup [model \| tts \| terminal \| gateway \| tools \| agent] [...]`	セクション別または全対話型セットアップ（`--quick`、`--reset`、`--non-interactive`）。
`hermes setup --portal`	ワンショットの Nous Portal ログイン：OAuth、Nous を推論プロバイダーとして設定、Tool Gateway にオプトイン。
`hermes portal [status \| open \| tools]`	Portal 認証状態と Tool Gateway ルーティング。サブコマンドがない場合は `status` を実行。

hermes login は削除されました。 OAuth とクレデンシャルプールには hermes auth を、プロバイダー選択には hermes model を、全ウィザードには hermes setup を使用してください。hermes auth logout <provider> で保存されたログインをクリアできます。

hermes model におけるローカルの OpenAI 互換エンドポイントとホスティング API の選択は、一般的な LLM ホスティング（レイテンシ、コスト、運用）と同じトレードオフに基づいています。

デフォルトが Ollama などの Qwen または Gemma で終わる場合、入力したモデル ID と同様に、サンプラーのデフォルト値が重要です。エージェント向けに最適化された Qwen と Gemma の推論パラメータの温度とペナルティプリセットの集約は、Qwen と Gemma のエージェント向け LLM 推論パラメータを参照してください。

設定ファイルと `hermes config` コマンド

設定はCLI 上書き → config.yaml → .env → デフォルトの順で解決されます。API キーは**.env** に、構造化された設定は**config.yaml** に保存してください。

コマンド	説明
`hermes config show`	有効な設定を表示。
`hermes config edit`	`$EDITOR` で `config.yaml` を開く。
`hermes config set key value`	値の設定（シークレットは `.env` へ、非シークレットは YAML へ）。
`hermes config path` / `hermes config env-path`	設定ファイルと env ファイルへのパスを表示。
`hermes config check`	欠落または古い設定を検出。
`hermes config migrate`	新規導入されたオプションを対話的に適用。

ファイルの場所 — 設定、シークレット、メモリ、スキル、セッション、ゲートウェイ状態、ログはすべて HERMES_HOME（デフォルト ~/.hermes）配下にあります。

セッション管理と `hermes profile`

コマンド	説明
`hermes sessions list`	最近のセッションをリスト表示。
`hermes sessions browse`	検索と再開付きの対話型ピッカー。
`hermes sessions export`	セッションのエクスポート（例：JSONL）。
`hermes sessions delete`, `prune`, `rename`, `stats`	1 つのセッションを削除、古いものを剪定、タイトルを変更、ストア統計を表示。
`hermes profile list` \| `use` \| `create` \| `delete` \| `show` \| `rename`	1 つのマシン上の分離された Hermes インスタンスの管理。
`hermes profile export` / `import`	プロファイルの tarball をアーカイブまたは復元。
`hermes profile alias`	プロファイルの高速切り替え用ラッパースクリプト。
`hermes worktree list`	スクラッチ worktree の監査：経過時間、サイズ、削除安全 여부。スクリプト向けに `--json`。
`hermes worktree prune`	クリーンでマージ済みのスクラッチツリーを削除。`--dry-run` で計画を表示、`--older-than N` でスウィープを限定。未コミット作業またはユニークなコミットがあるツリーは保持されます。

スティッキーデフォルトプロファイルを変更せずにアドホックな実行を行う場合は、hermes -p work chat -q "..." を使用してください。TTY ではセッション内に留まります。プロファイル実行が終了する場合に --oneshot を追加してください。

スキルハブ、ツールセット、シェルフック、プラグイン

ロールに基づいた実際の本番ワークフローに調整されたプロファイルファーストの設定とスキルについては、本番セットアップ向け Hermes AI アシスタントスキルを参照してください。SKILL.md ファイルの作成とデバッグ（メタデータ、段階的開示、条件付き表示）については、Hermes Agent スキル作成 — SKILL.md 構造とベストプラクティスを参照してください。

コマンド	説明
`hermes tools`	プラットフォーム毎のツール有効化の対話型管理。`--summary` で現在の選択を表示。
`hermes skills browse`, `search`, `inspect`, `install`, `list`, `check`, `update`, `audit`, `uninstall`, `publish`, `snapshot`, `tap`, `config`	レジストリと URL インストールを含むスキルハブワークフロー。
`hermes curator status`, `run`, `pause`, `pin`, `rollback`, …	バックグラウンドスキルメンテナンスと安全なロールバック。
`hermes hooks list`, `test`, `revoke`, `doctor`	設定で宣言されたシェルフックとホワイトリスト。
`hermes plugins`	プラグインのインストール、有効化、無効化、削除を行う複合 UI またはサブコマンド。

組み込みメモリと `hermes memory` プロバイダー

組み込みの MEMORY.md / USER.md は引き続き有効です。外部プロバイダーは任意の記憶レイヤーを追加します。そのアーキテクチャが実際にどのように動作するかについては、Hermes Agent メモリシステム — 永続 AI メモリの実際の動作をお読みください。外部バックエンドとアクティベーションのトレードオフを比較するには、エージェントメモリプロバイダー比較 — Honcho、Mem0、Hindsight、その他 5 つを参照してください。

コマンド	説明
`hermes memory setup`	外部メモリプロバイダー設定の対話型セットアップ。
`hermes memory status`	アクティブなプロバイダー設定を表示。
`hermes memory off`	外部プロバイダーを無効化。組み込みファイルは残る。

プロバイダーがアクティブな場合、追加のプロバイダー固有のトップレベルサブコマンドが登録される可能性があります — hermes --help を実行して現在何が接続されているかを確認してください。

メッセージングゲートウェイ、DM ペアリング、プラットフォーム

コマンド	説明
`hermes gateway setup`	メッセージングプラットフォーム設定の対話型セットアップ。
`hermes gateway run`	フォアグラウンドゲートウェイ（WSL、Docker、Termux で推奨）。
`hermes gateway start` \| `stop` \| `restart` \| `status`	systemd / launchd サービス制御（`--all` はすべてのプロファイルのゲートウェイに影響）。
`hermes gateway install` \| `uninstall`	ユーザーレベルのバックグラウンドサービスのインストールまたは削除。
`hermes gateway migrate [--dry-run]`	プロファイル別のゲートウェイを 1 つのホストゲートウェイに集約。`hermes update` はプリフライトがブロックしない限りこれを実行します。`--standalone` ロールバックはありません。
`hermes pairing list` \| `approve` \| `revoke` \| `clear-pending`	メッセージングボットの DM ペアリング承認。
`hermes whatsapp`	WhatsApp ブリッジのペアリングフロー。
`hermes slack manifest`	ゲートウェイのスラッシュパリティを持つ Slack アプリマニフェストを生成。

WSL では、gateway start が正常に動作しない場合、tmux 内で hermes gateway run を実行することがレジリエントなパターンです。同じゲートウェイレイヤーを使用するエンドツーエンドの電話ワークフローについては、携帯電話からの Hermes ボイスコントロールを参照してください。専用サーバーで別々のデスクトップクライアントを使用する場合、Hermes Agent ヘッドレスサーバーとリモートデスクトップセットアップに従ってください。

Cron スケジューラー、Webhook、カンバン

コマンド	説明
`hermes cron …`	スケジュールされたプロンプトの作成、編集、一時停止、再開、実行、削除（手動スケジューラーパスには `tick`）。
`hermes webhook subscribe`, `list`, `remove`, `test`	イベント駆動型実行用の動的 Webhook ルート。
`hermes kanban …`	SQLite をバックエンドとするマルチプロファイルタスクボード。`dispatch` がワーカーを駆動。

セルフホスト型ゲートウェイで hermes kanban の実践的な並行パターンが必要の場合、セルフホスト型 LLM ワークフロー向け Hermes Agent カンバンを参照してください。

`hermes doctor`、ログ、バックアップ、使用量インサイト

コマンド	説明
`hermes doctor [--fix]`	対話型診断とオプションの自動修復。
`hermes status [--all] [--deep]`	簡潔な状態。必要に応じてより深いチェック。
`hermes dump [--show-keys]`	Discord や GitHub Issues に貼りやすいセットアップサマリー。
`hermes debug share`	編集済みデバッグバンドルをパストサービスにアップロード（または `--local`）。
`hermes logs [agent \| errors \| gateway \| list]`	プロファイルのログディレクトリ下でログのテールとフィルタリング。
`hermes backup`, `hermes import`	ホームデータの Zip スナップショットと復元パス。
`hermes insights [--days N] [--source …]`	トークン、コスト、活動の分析。

アップグレード後に何か問題が発生した場合、hermes doctor、hermes status、hermes logs errors -f が最速のトリアージループを形成します。

MCP、ACP、Web ダッシュボード、OpenClaw 移行

コマンド	説明
`hermes mcp serve`	Hermes を MCP サーバーとして実行。
`hermes mcp add`, `remove`, `list`, `test`, `configure`	Hermes からの MCP クライアント接続の管理。
`hermes acp`	エディター向けの Agent Client Protocol stdio サーバー（追加インストールが必要な場合があります）。
`hermes dashboard [--port …] [--host …]`	ローカル Web ダッシュボード（`pip install hermes-agent[web]`）。
`hermes claw migrate …`	OpenClaw スタイルの設定を Hermes に移行（`--dry-run`、プリセット、オプションのシークレット）。
`hermes import-agent [claude-code \| codex]`	Claude Code（`~/.claude`）または Codex CLI（`~/.codex`）セットアップのインポート。常にプレビューを先に行い、API キーはコピーされません。`--sync` でファイルが変更されたソースを再インポート。

OpenClaw 移行 — hermes claw migrate はレガシーな OpenClaw ホームディレクトリを読み取ります。ドライランレビュー、競合ポリシー、シークレット処理、チャネル引き継ぎを含む完全な段階的な切り替えは、OpenClaw から Hermes Agent への安全な移行方法に記載されています。移行前のそのスタックの見た目については、OpenClaw ケーススタディを参照してください。

Hermes CLI セッション内のスラッシュコマンド

/ を入力してオートコンプリートを使用できます。コマンドは大文字小文字を区別しません。スキルは追加の /skill-name ルートを登録します。以下のテーブルは厳選されたサブセットです。完全なレジストリについては、この記事の末尾にある公式 Hermes Agent ドキュメントを参照してください。

セッションフロー、バックグラウンドタスク、目標

コマンド	説明
`/new`, `/reset`	新しいセッション ID と履歴。
`/resume [name]`	名前付きセッションの再開。
`/compress [focus]`	オプションのフォーカストピックを伴う手動コンテキスト圧縮。
`/retry`, `/undo`	最後のターンの再試行、または最後のやり取りの破棄。
`/title …`	後での `/resume` 用のセッション命名。
`/background …`, `/queue …`, `/steer …`	並行バックグラウンド実行、キュー入り次のプロンプト、次のツール後のループ中ナッジ。
`/goal …`	ジャッジループを備えた永続的なマルチターンの目標（`status`、`pause`、`resume`、`clear`）。
`/branch`, `/fork`	代替探索のために会話を分岐。
`/btw …`	現在の会話に関する脇の話。メインターンを中断しません。
`/context [all]`	コンテキスト使用量の内訳。`all` でスキル別とツールセット別のコストを追加。
`/status`	セッション情報とローカルな要約（最近のターン、ツール、ファイル）。モデル呼び出しなし。
`/sessions`	セッション内ピッカー：フィルタリング、矢印、Enter で再開。

モデル、ツールトグル、スキル、リロード

コマンド	説明
`/model … [--global]`	設定済みプロバイダー間でモデルの切り替え。`--global` でデフォルトを永続化。
`/tools …`, `/toolsets`	セッションツールトグルとツールセットのリスト。
`/skills …`	チャットからスキルの検索、インストール、管理。
`/cron …`	CLI セッションからのスケジュールタスク UI。
`/reload-mcp`	設定から MCP サーバーをリロード。
`/reload`	リスタートせずに `.env` を実行中のセッションにリロード。

使用量、ヘルプ、終了

コマンド	説明
`/usage`, `/insights`	トークンとコストの可視化。分析スナップショット。
`/voice on`, `/voice tts`	CLI ボイスレコーディング（デフォルト `Ctrl+B`）と音声再生。
`/reasoning high`	セッションの推論エフォートを向上。
`/help`, `/quit`	ヘルプまたは CLI の終了。

! で始まる行は、モデルターンなしでホストシェル上で実行されます（!git status）。会話には入らず、危険なコマンドは引き続き承認プロンプトに当たります。Ctrl+S はセッション専用のコンポーザー草稿をスタッシュします。ディスクに書き込まれることはありません。

メッセージングアプリ（Telegram、Discord、Slack など）は、重複するスラッシュセットに加えて /approve、/restart、/commands、および関連するゲートウェイ専用ヘルパーを公開します — プラットフォームの違いは、以下の公式 Hermes Agent ドキュメントのスラッシュコマンドリファレンスに記載されています。

その他有用な読み物

このサイトの関連ページ：

AI システム — セルフホスト型アシスタント、RAG、ローカルインフラ — クラスタ概要とスタックへのアシスタントの組み入れ方
AI システムメモリ — メモリハブと隣接するガイド

公式 Hermes Agent ドキュメント

hermes-agent.nousresearch.com 上のアップストリームドキュメント：

ヒント。 hermes dump と hermes doctor --fix を筋肉記憶に刻み込みましょう — それらは曖昧な「何か壊れた」レポートを、既知の正常な設定に対する実行可能な差分に変換します。