Hermes Managed Mode

Managed mode is the default Hatcher runtime path for Hermes agents. Hatcher owns the container lifecycle, while the agent keeps a persistent workspace volume for memory, sessions, skills, logs, and generated files.

What You Get

Persistent workspace under the Hermes home directory
Generated config.yaml, .env, and SOUL.md
Dashboard access to config, files, logs, chat, integrations, and billing
Included File Manager and Full Logs on every tier
Skills/tools available without separate plugin billing
Workspace quota tracking by tier
Hosted model routing through AI Credits, or BYOK provider-paid routing

Startup Flow

Hatcher creates or reuses the agent Docker volume.
Init writes canonical Hermes settings, model config, integration secrets, and SOUL.md.
Hosted mode receives Hatcher LLM proxy credentials; BYOK receives encrypted provider credentials at startup.
The Hermes container starts on port 8642.
Health checks, logs, push notifications, and lifecycle state are tracked by Hatcher.

File Layout


/home/hermes/
├── .hermes/
│   ├── config.yaml
│   ├── .env
│   ├── SOUL.md
│   ├── memories/
│   ├── sessions/
│   ├── cron/
│   ├── logs/
│   ├── skills/
│   ├── state.db
│   └── response_store.db
└── (other files the agent writes)

Editing Config

Use the dashboard config screen for the supported settings:

Setting	Purpose
Provider/model	Hosted or BYOK LLM selection
Max turns	Tool-call loop budget
Compression	Conversation compression threshold
Memory	Hermes memory behavior
Streaming	Token streaming behavior
Integrations	Platform credentials and routing

Secrets and auth-critical fields are not editable as raw files. Change BYOK keys and platform tokens through the dashboard so they remain encrypted and masked.

Workspace Quotas

Tier	Workspace quota
Free	2 GB
Starter	10 GB
Pro	25 GB
Business	50 GB
Founding Member	40 GB

Workspace quota is enforced as usage grows. Hatcher does not preallocate the full quota for every agent.

FAQ

Can I back up my memory files? Use File Manager or ask the agent to package/export the files it owns in the workspace.

Will deleting an agent remove files? Yes. Deleting an agent removes the associated workspace volume.

Can I change model config manually? Use the dashboard model selector. Direct edits to provider credentials or proxy config can break hosted routing.

Does managed mode apply to OpenClaw too? Yes. OpenClaw has its own managed-mode path and file layout. See OpenClaw Managed Mode.