hermes-agent

Hermes Agent — デプロイと管理

Hermes Agent は Nous Research による自己改善型の AI エージェントです。経験からスキルを作成し、過去の会話を検索し、セッションをまたいでユーザーモデルを構築します。

• リポジトリ: github.com/NousResearch/hermes-agent（スター 11k 以上、MIT ライセンス）
• ドキュメント: hermes-agent.nousresearch.com/docs/
• スキルハブ: agentskills.io

クイックリファレンス

項目	値
設定ディレクトリ	~/.hermes/
設定ファイル	~/.hermes/config.yaml
シークレット	~/.hermes/.env
アイデンティティ	~/.hermes/SOUL.md
ログ	~/.hermes/logs/
セッション	~/.hermes/sessions/
スキル	~/.hermes/skills/
メモリー	~/.hermes/memories/
cron ジョブ	~/.hermes/cron/
ゲートウェイ設定	~/.hermes/gateway.json

インストール

クイックインストール（Linux/macOS/WSL2）

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

uv、Python 3.11、Node.js v22、ripgrep、ffmpeg を自動インストールします。前提条件は git のみです。 ネイティブの Windows はサポートされていません。WSL2 を使用してください。

手動インストール

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"
uv pip install -e "./mini-swe-agent"
npm install  # optional, for MCP/browser tools

mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env
chmod 600 ~/.hermes/.env

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

Docker でのデプロイ

docker build -t hermes-agent:local .
docker run --rm -it \
  -v "$PWD:/home/agent/workspace" \
  -v "$HOME/.hermes:/home/agent/.hermes" \
  hermes-agent:local hermes

agent ユーザーとして実行されます。データを永続化するには ~/.hermes をマウントしてください。

コミュニティ製 Docker イメージ：

• xmbshwll/hermes-agent-docker
• Crustocean/hermes-agent-template
• ellickjohnson/portainer-stack-hermes

動作確認

hermes doctor        # Diagnose issues
hermes doctor --fix  # Auto-repair
hermes status --deep # Full status check

設定

設定の完全なリファレンス：references/configuration.md

最初に行う基本設定

hermes model          # Select LLM provider/model
hermes tools          # Configure enabled tools
hermes config check   # Check for missing options
hermes config migrate # Add options introduced in updates

最小限の .env

# Pick one provider
ANTHROPIC_API_KEY=sk-ant-...
# OR
OPENROUTER_API_KEY=sk-or-...

設定管理

hermes config show        # View current
hermes config edit        # Open in editor
hermes config set KEY VAL # Set value (auto-routes secrets to .env)
hermes config path        # Print config file path

メッセージングゲートウェイ

ゲートウェイの完全なリファレンス：references/messaging.md

クイックセットアップ

hermes gateway setup     # Interactive platform config
hermes gateway install   # Install as user systemd service
sudo loginctl enable-linger $USER  # Survive logout
hermes gateway start
hermes gateway status

対応プラットフォーム

Telegram、Discord、Slack、WhatsApp、Signal、SMS、メール、Home Assistant、 Mattermost、Matrix、DingTalk、Webhook に対応しています。

セキュリティ（重要）

# Set explicit allowlists in .env — NEVER use GATEWAY_ALLOW_ALL_USERS=true
TELEGRAM_ALLOWED_USERS=123456789,987654321
DISCORD_ALLOWED_USERS=123456789012345678

# DM pairing for unknown users
hermes pairing approve telegram XKGH5N7P
hermes pairing list
hermes pairing revoke telegram 123456789

OpenClaw からの移行

Hermes はセットアップ中に ~/.openclaw を自動検出します。

hermes claw migrate              # Interactive full migration
hermes claw migrate --dry-run    # Preview first
hermes claw migrate --overwrite  # Overwrite conflicts

移行対象：SOUL.md、メモリー、スキル、許可リスト、メッセージング設定、API キー、TTS ファイル。

よく使う操作

タスク	コマンド
対話チャット	hermes
1 回限りの問い合わせ	hermes chat -q "..."
モデルの変更	hermes model
更新	hermes update
セッションの再開	hermes -c または hermes -r <id>
スキルの閲覧	hermes skills browse
スキルのインストール	hermes skills install <name>
cron ジョブ	hermes cron list / hermes cron create
分析	hermes insights --days 7
アンインストール	hermes uninstall --full --yes

Systemd（本番環境）

# User service
hermes gateway install
sudo loginctl enable-linger $USER
journalctl --user -u hermes-gateway -f

# System service (starts at boot)
sudo hermes gateway install --system

トラブルシューティング

症状	対処方法
hermes: command not found	source ~/.bashrc を実行し、PATH に ~/.local/bin が含まれていることを確認します
依存関係の不足	hermes doctor --fix
ゲートウェイが起動しない	~/.hermes/logs/gateway.log を確認します
認証エラー	hermes login --provider <name> を実行するか、.env を確認します
更新後に設定が古いまま	hermes config migrate
移行時の問題	まず hermes claw migrate --dry-run を実行します

プロファイルとの連携

リモートサーバーへのデプロイ後、デバイスプロファイルを更新します。

1. hermes-agent を profile.servers[].apps[] に追加します
2. デプロイ内容を profile.deployments{} に記録します
3. log_admin_event でログに記録します