For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
User Guide
User Guide
    • Home
      • Overview
      • Architecture Overview
      • Ecosystem
      • Release Notes
      • Prerequisites
      • Quickstart with Hermes
      • Inference Options
      • Use Local Inference
      • Switch Inference Providers
      • Manage Sandbox Lifecycle
      • Runtime Controls
      • Set Up Messaging Channels
      • Workspace Files
      • Backup and Restore
      • Install Hermes Plugins
      • Approve or Deny Network Requests
      • Customize the Network Policy
      • Integration Policy Examples
      • Monitor Sandbox Activity
      • Security Best Practices
      • Credential Storage
      • Architecture Details
      • Commands
      • Which CLI to Use
      • Network Policies
      • Troubleshooting
      • Agent Skills
      • Report Vulnerabilities
      • License
      • Discord
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogoNemoClaw
On this page
  • Important Hermes State
  • Persistence Behavior
  • Editing State
  • Next Steps
Manage Sandboxes

Workspace Files

||View as Markdown|
Previous

Messaging Channels

Next

Backup and Restore Workspace Files

Hermes stores durable agent state under /sandbox/.hermes/ instead of the OpenClaw workspace directory. The main Hermes configuration lives in /sandbox/.hermes/config.yaml, environment settings live in /sandbox/.hermes/.env, and runtime state such as logs, memory, platform sessions, and the SQLite state database lives under the same .hermes tree.

Important Hermes State

PathPurpose
/sandbox/.hermes/config.yamlNemoClaw-generated Hermes runtime configuration.
/sandbox/.hermes/.envNemoClaw-generated environment and messaging placeholders.
/sandbox/.hermes/state.dbHermes SQLite state database.
/sandbox/.hermes/platforms/Messaging platform state, including QR-paired sessions such as WhatsApp.
/sandbox/.hermes/logs/Hermes runtime logs.
/sandbox/SOUL.mdDurable top-level Hermes persona file preserved by NemoClaw snapshots.

Persistence Behavior

Hermes state lives in the sandbox’s persistent state volume, not only in the container image. Normal restarts preserve that state. Rebuilds and upgrades use NemoClaw’s snapshot flow to preserve manifest-defined Hermes state, including SOUL.md and the SQLite database behind .hermes/state.db.

Running nemohermes <name> destroy deletes the sandbox and its persistent state volume. Back up important state before destroying a Hermes sandbox.

Editing State

Prefer NemoClaw host commands for generated configuration such as model, provider, messaging, and policy settings. Direct edits to /sandbox/.hermes/config.yaml or /sandbox/.hermes/.env can be overwritten by rebuilds. Use nemohermes <name> connect when you need to inspect runtime files interactively, or use openshell sandbox download and openshell sandbox upload for manual file transfer.

Next Steps

  • Backup and Restore workspace files
  • Commands reference