NeoAgent

Migrating from OpenClaw or Hermes

NeoAgent can copy supported files and selected configuration from a default OpenClaw or Hermes installation. Run a dry run first and review imported content before using it with an agent.

neoagent migrate           # detect and migrate interactively
neoagent migrate dry-run   # preview what would be migrated
neoagent migrate status    # check what's detected

What gets migrated

Data	OpenClaw source	Hermes source	Destination
Skills	`~/.openclaw/skills/*.md`	`~/.hermes/skills/*.md`	`~/.neoagent/agent-data/skills/openclaw-imports/` or `hermes-imports/`
Memory files	`SOUL.md`, `MEMORY.md`, `USER.md`	`MEMORY.md`, `USER.md`	`~/.neoagent/agent-data/memory/openclaw/` or `hermes/`
API keys	from `.env`	from `.env`	merged into `~/.neoagent/.env`

Prerequisites

NeoAgent installed with the repository installer
An existing OpenClaw (~/.openclaw/) or Hermes (~/.hermes/) installation

Running the migration

neoagent migrate status — reports which source installations were found
neoagent migrate dry-run — lists the skills, memory files, and API keys each source would contribute, without writing anything
neoagent migrate — asks which sources to import

When an API key already exists in your NeoAgent .env, the interactive flow stops and asks per key:

  ⚠️  Conflict: OPENAI_API_KEY
      Existing in: neoagent
      Incoming from: openclaw
    [1] Keep existing
    [2] Overwrite with new
    [3] Skip this key
  Choice [1]:

The default keeps your existing key.

Source paths

OpenClaw

Data	Path
Config	`~/.openclaw/openclaw.json`
Skills	`~/.openclaw/skills/`
Memory	`~/.openclaw/workspace/SOUL.md`, `MEMORY.md`, `USER.md`
Legacy	`~/.clawdbot/`

Hermes

Data	Path
Config	`~/.hermes/config.yaml`
Skills	`~/.hermes/skills/`
Memory	`~/.hermes/memories/MEMORY.md`, `USER.md`
API keys	`~/.hermes/.env`

API keys detected and merged

ANTHROPIC_API_KEY, OPENAI_API_KEY, XAI_API_KEY, GOOGLE_AI_KEY, MINIMAX_API_KEY, BRAVE_SEARCH_API_KEY, DEEPGRAM_API_KEY, TELEGRAM_BOT_TOKEN, OPENROUTER_API_KEY, ELEVENLABS_API_KEY, SLACK_BOT_TOKEN, DISCORD_BOT_TOKEN

Imported Markdown is preserved as source material. Copying it does not turn every line into a verified structured memory fact. Review it for stale, conflicting, or sensitive information.

Post-migration steps

neoagent status — verify the installation
neoagent start — start the server
Review imported skills in ~/.neoagent/agent-data/skills/openclaw-imports/ and hermes-imports/
Review imported memory in ~/.neoagent/agent-data/memory/
Reconfigure messaging channels and official integrations in the NeoAgent UI
Test recall with non-sensitive facts before relying on imported memory

Troubleshooting

“No OpenClaw or Hermes installation detected” — Installation must be at the default path. If it’s elsewhere, migrate manually:

Copy .md skill files to ~/.neoagent/agent-data/skills/
Copy memory files to ~/.neoagent/agent-data/memory/
Merge API keys into ~/.neoagent/.env

“Permission denied” errors — Check read permissions on source directories and write permissions on ~/.neoagent/.

Migration partially completed — Safe to re-run. Only new files are copied; existing files are not overwritten.

This site is open source. Improve this page.