Skip to content

The agent that grows with you

feat: setup and hermes migrate offer the OpenBot import too

Tekniumafc5c55d4748
diff --git a/hermes_cli/setup_agent_import.py b/hermes_cli/setup_agent_import.py
index 699d9b17825..c250ba0653c 100644
--- a/hermes_cli/setup_agent_import.py
+++ b/hermes_cli/setup_agent_import.py
@@ -42,6 +42,9 @@ IMPORT_SOURCES: tuple[ImportSource, ...] = (
"Applications/Grok Bot.app", ".config/Grok Bot",
"AppData/Roaming/Grok Bot", "AppData/Local/Programs/Grok Bot"),
exports=("Downloads/grok-bot-export*",)),
+ # OpenBot (nightly-labs/openbot): Electron user data with openbot.db, per OS, or its agent workspaces.
+ ImportSource("openbot", "OpenBot", ("Library/Application Support/OpenBot", ".config/OpenBot",
+ "AppData/Roaming/OpenBot", "OpenBot/Agents")),
)
diff --git a/hermes_cli/subcommands/migrate.py b/hermes_cli/subcommands/migrate.py
index 5e0329e001e..0ca4fbbe1c1 100644
--- a/hermes_cli/subcommands/migrate.py
+++ b/hermes_cli/subcommands/migrate.py
@@ -10,7 +10,7 @@ def build_migrate_parser(subparsers) -> None:
migrate_parser = subparsers.add_parser(
"migrate", help="Move over from another agent, or migrate retired models and deprecated settings",
description="With no type: find another agent's setup on this computer (OpenClaw, Claude Code, "
- "Codex CLI, Cursor, Grok Bot) and offer to import it. Name an agent to import from it; "
+ "Codex CLI, Cursor, Grok Bot, OpenBot) and offer to import it. Name an agent to import from it; "
"xai and relay rewrite deprecated settings in the active config.yaml.")
migrate_subparsers = migrate_parser.add_subparsers(dest="migrate_type")
@@ -60,11 +60,11 @@ def _add_agent_import_parsers(migrate_subparsers) -> None:
sub.add_argument("--dry-run", action="store_true", help="Preview only")
sub.add_argument("--overwrite", action="store_true", help="Replace existing items on name conflicts")
sub.add_argument("-y", "--yes", action="store_true", help="Skip the confirmation prompt")
- if source.name == "grok-bot":
+ if source.name in ("grok-bot", "openbot"):
sub.add_argument("--activate-routines", action="store_true",
help="Create the imported cron jobs running instead of paused")
sub.add_argument("--bot", action="append", metavar="NAME",
- help="Only this Bot from an export holding several (repeatable)")
+ help="Only this Bot or agent, by name (repeatable)")
sub.set_defaults(func=cmd_migrate_agent, migrate_agent=source.name)
diff --git a/website/docs/reference/cli-commands.md b/website/docs/reference/cli-commands.md
index 8bb62e2f214..4747c6e5a83 100644
--- a/website/docs/reference/cli-commands.md
+++ b/website/docs/reference/cli-commands.md
@@ -600,17 +600,17 @@ Pull API keys from an external secret manager at process startup instead of stor
```bash
hermes migrate # find another agent's setup here and offer to import it
-hermes migrate <agent> # openclaw, claude-code, codex, cursor or grok-bot
+hermes migrate <agent> # openclaw, claude-code, codex, cursor, grok-bot or openbot
hermes migrate <type> # xai, relay
```
-Bare `hermes migrate` looks for OpenClaw, Claude Code, Codex CLI, Cursor and Grok Bot on this computer and offers to import what it finds, the same step a first `hermes setup` runs. `hermes migrate <agent>` imports from that agent even when nothing is detected: it installs the [`agent-importers`](../user-guide/import-from-other-agents.md) plugin from the catalog when it is missing, then runs `hermes import-agent <agent>` (preview, then confirmation). It takes `--source`, `--dry-run`, `--overwrite` and `-y`; `grok-bot` also takes `--activate-routines` and `--bot <name>`.
+Bare `hermes migrate` looks for OpenClaw, Claude Code, Codex CLI, Cursor, Grok Bot and OpenBot on this computer and offers to import what it finds, the same step a first `hermes setup` runs. `hermes migrate <agent>` imports from that agent even when nothing is detected: it installs the [`agent-importers`](../user-guide/import-from-other-agents.md) plugin from the catalog when it is missing, then runs `hermes import-agent <agent>` (preview, then confirmation). It takes `--source`, `--dry-run`, `--overwrite` and `-y`; `grok-bot` and `openbot` also take `--activate-routines` and `--bot <name>`.
The `xai` and `relay` types diagnose and (optionally) rewrite the active `config.yaml` to replace references to retired models or deprecated settings. A timestamped backup of the original `config.yaml` is taken before any rewrite (skip with `--no-backup`).
| Subcommand | Description |
|------------|-------------|
-| `openclaw`, `claude-code`, `codex`, `cursor`, `grok-bot` | Import that agent's setup (see above). |
+| `openclaw`, `claude-code`, `codex`, `cursor`, `grok-bot`, `openbot` | Import that agent's setup (see above). |
| `xai` | Scan `config.yaml` for references to xAI models scheduled for retirement on May 15, 2026 and (with `--apply`) rewrite them in-place to the official replacements per the xAI migration guide. Defaults to dry-run. |
Common flags for migration subcommands:
diff --git a/website/docs/user-guide/import-from-other-agents.md b/website/docs/user-guide/import-from-other-agents.md
index 80112127bbd..1fdf9ed44a6 100644
--- a/website/docs/user-guide/import-from-other-agents.md
+++ b/website/docs/user-guide/import-from-other-agents.md
@@ -1,18 +1,18 @@
---
sidebar_position: 9
title: "Import from Other Agents"
-description: "One-command import of an OpenClaw (~/.openclaw), Claude Code (~/.claude), OpenAI Codex CLI (~/.codex), Cursor (~/.cursor) or Grok Bot setup into Hermes — instructions, rules, allowlists, MCP servers, skills, memories and Grok Bot routines."
+description: "One-command import of an OpenClaw (~/.openclaw), Claude Code (~/.claude), OpenAI Codex CLI (~/.codex), Cursor (~/.cursor), Grok Bot or OpenBot setup into Hermes — instructions, rules, allowlists, MCP servers, skills, memories and Grok Bot / OpenBot routines."
---
# Import from Other Agents
-`hermes import-agent` imports your existing **OpenClaw**, **Claude Code**, **OpenAI Codex CLI**, **Cursor** or **Grok Bot** setup into Hermes with one command. You always see a per-item plan before anything is written, and `--dry-run` never touches disk.
+`hermes import-agent` imports your existing **OpenClaw**, **Claude Code**, **OpenAI Codex CLI**, **Cursor**, **Grok Bot** or **OpenBot** setup into Hermes with one command. You always see a per-item plan before anything is written, and `--dry-run` never touches disk.
The command comes from the official **`agent-importers` plugin** from the [plugin catalog](./features/plugins.md), maintained by Nous Research in [NousResearch/hermes-official-plugins](https://github.com/NousResearch/hermes-official-plugins/tree/main/agent-importers).
## The easy way: `hermes setup`
-On a fresh install, `hermes setup` checks for `~/.openclaw` (or legacy `~/.clawdbot` / `~/.moltbot`), `~/.claude`, `~/.codex`, `~/.cursor` and the Grok Bot desktop app (or a `grok-bot-export*` file in `~/Downloads`) before anything else. When it finds one it asks **"Import your setup from Claude Code?"** (naming what it found); with several found you then pick which from a checklist, all checked. Say yes and setup installs the `agent-importers` plugin from the catalog, unless you already have it, and runs the import below for each pick, preview and confirmation included. For OpenClaw it passes `--migrate-secrets`, as Hermes' old built-in OpenClaw step did, so your API keys and bot tokens come over and the provider and messaging sections that follow are already filled in. If you then pick Quick Setup and the import brought a model along with its key, setup asks whether to keep that model (the default) or switch to Nous Portal. Say no, or have none of these folders, and nothing is installed. Already set up? Run `hermes migrate` for the same offer, `hermes migrate <agent>` (`openclaw`, `claude-code`, `codex`, `cursor`, `grok-bot`) to import from one agent, installing the plugin when it is missing, or use the commands below.
+On a fresh install, `hermes setup` checks for `~/.openclaw` (or legacy `~/.clawdbot` / `~/.moltbot`), `~/.claude`, `~/.codex`, `~/.cursor` and the Grok Bot desktop app (or a `grok-bot-export*` file in `~/Downloads`) and OpenBot before anything else. When it finds one it asks **"Import your setup from Claude Code?"** (naming what it found); with several found you then pick which from a checklist, all checked. Say yes and setup installs the `agent-importers` plugin from the catalog, unless you already have it, and runs the import below for each pick, preview and confirmation included. For OpenClaw it passes `--migrate-secrets`, as Hermes' old built-in OpenClaw step did, so your API keys and bot tokens come over and the provider and messaging sections that follow are already filled in. If you then pick Quick Setup and the import brought a model along with its key, setup asks whether to keep that model (the default) or switch to Nous Portal. Say no, or have none of these folders, and nothing is installed. Already set up? Run `hermes migrate` for the same offer, `hermes migrate <agent>` (`openclaw`, `claude-code`, `codex`, `cursor`, `grok-bot`, `openbot`) to import from one agent, installing the plugin when it is missing, or use the commands below.
## By hand
@@ -87,6 +87,10 @@ Grok Bot keeps your Bots, routines and skills in its cloud account and has no ex
Routines arrive paused so they don't run twice while the Grok copy is still on: turn it off in Grok Bot, then `hermes cron resume <id>` (the import prints each id), or pass `--activate-routines`. Point a job's output somewhere with `hermes cron edit <id> --deliver telegram`. An export carrying credential-looking keys is refused, and token-shaped text is redacted.
+### OpenBot
+
+`hermes migrate openbot` (or `hermes import-agent openbot`) reads the OpenBot desktop app's local database (`openbot.db` in `~/Library/Application Support/OpenBot`, `~/.config/OpenBot` or `%APPDATA%\OpenBot`; read-only, so OpenBot can stay open) and each agent's workspace under `~/OpenBot/Agents`. Routines become paused cron jobs with the same schedule and time zone, the agent's description becomes `SOUL.md` (or memory entries), its memories go to `memories/MEMORY.md`, its workspace skills to `skills/openbot-imports/`, and MCP servers to `config.yaml` with secret-looking env vars stripped. `--bot <name>` picks agents; `hermes -p <profile> ...` gives an agent its own profile. Chats and provider accounts stay in OpenBot.
+
## What is never imported
**API keys and credentials.** (OpenClaw is the one exception: its allowlisted API keys and bot tokens come over only when you pass `--migrate-secrets`.) Credential files (`~/.claude/.credentials.json`, `~/.codex/auth.json`, `~/.cursor/cli-config.json`) are never read, and MCP server environment variables or headers with secret-looking names (`*_TOKEN`, `*_API_KEY`, `Authorization`, ...) are stripped and listed in the report so you can re-add them deliberately. Run `hermes setup` to configure providers, or add secrets to `~/.hermes/.env`.