OpenClaw LaunchOpenClaw Launch
← Home

Guide

Hermes Agent + CC Switch: One Config Switcher Across Tools

CC Switch (farion1231/cc-switch) is a cross-platform desktop GUI that manages configs for Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw — API keys, provider routing, MCP servers, skills. This guide adds Hermes Agent to that switcher.

What CC Switch Does

If you have Claude Code, Codex, OpenCode, and OpenClaw all installed on the same machine, each tool reads its own config file with its own API keys, MCP entries, and provider routing. Editing one breaks the others. CC Switch is a GUI layer that lets you toggle profiles (work vs personal, prod-key vs dev-key) and keeps each tool's config in sync.

Why Add Hermes to CC Switch?

  • If you run Hermes locally for testing and Hermes on OpenClaw Launch for production, the keys differ — CC Switch swaps them with a click.
  • Shared MCP server config — the same MCP entries (chrome-devtools, context7, github) can be reused across Claude Code, Codex, and Hermes.
  • Faster experimentation — swap from Claude Sonnet 4.6 to GLM 4.6 to MiMo V2 Pro across all your tools with one click.

Hermes Config Paths CC Switch Touches

~/.hermes/config.yaml         # main Hermes config (model, provider, BYOK keys)
~/.hermes/mcp.json            # MCP server registrations
~/.hermes/skills/             # installed skills directory

CC Switch profiles can hold alternate copies of config.yaml and mcp.json, swapping them in/out when you flip profiles.

Step 1: Install CC Switch

Download from github.com/farion1231/cc-switch/releases. macOS, Windows, and Linux builds available.

Step 2: Register Hermes as a Tool

In CC Switch, open Settings → Add Tool. Pick Custom and point it at ~/.hermes/. CC Switch reads the standard config layout there.

Step 3: Create Profiles

Typical setup:

  • local-dev — local Hermes on your laptop, BYOK with a cheap model (DeepSeek / Qwen / MiMo V2.5)
  • prod-openrouter — Hermes on OpenClaw Launch, OpenRouter key, model = Claude 4.6 or GPT-5
  • byok-anthropic — direct Anthropic key, Sonnet 4.6, no OpenRouter middleman

Switch with the menu bar / system tray icon. CC Switch swaps the config files in <1s.

Hermes on OpenClaw Launch Note

If you use managed Hermes on OpenClaw Launch, your BYOK is set in the dashboard, not in a local file. CC Switch can still hold a local-dev profile alongside it — useful if you have a local Hermes binary for testing.

Limits

  • CC Switch is GUI-only — no headless mode for CI/CD pipelines.
  • It doesn't know about gateway tokens or per-channel auth — only model + provider + MCP config.
  • Hot-reload: Hermes picks up most config changes on next request, but provider auth changes require hermes gateway restart.

What's Next?

Skip the Switcher

OpenClaw Launch keeps your Hermes config in the dashboard — one place, no profile juggling.

Deploy Hermes