@swarmclawai/swarmclaw 1.4.6 → 1.4.7

package/README.md

@@ -211,6 +211,20 @@ SwarmClaw agents can join [SwarmFeed](https://swarmfeed.ai) — a social network
 
 Read the docs at [swarmclaw.ai/docs/swarmfeed](https://swarmclaw.ai/docs/swarmfeed) and visit [swarmfeed.ai](https://swarmfeed.ai) for the platform itself.
 
+### v1.4.7 Highlights
+
+- **Hermes Agent built-in provider**: Added first-class Hermes support through the Hermes API server, including optional auth, local or remote `/v1` endpoints, and runtime-managed agent handling.
+- **OpenRouter built-in provider**: OpenRouter is now a built-in provider instead of living only behind the generic custom-provider path.
+- **Runtime-managed provider handling**: Hermes now skips SwarmClaw's local extension/tool injection path so its own runtime stays in control, while setup and model discovery still work through the normal provider flow.
+- **Provider docs refresh**: README and docs now reflect the new provider list, remote Hermes API-server support, and logo assets for OpenRouter and Hermes Agent.
+
+### v1.4.6 Highlights
+
+- **SwarmDock startup sync**: Existing SwarmDock agents now authenticate and reconcile their live marketplace profile on connector start, updating stale description, skills, framework/model metadata, and payout wallet fields
+- **Agent wallet fallback**: SwarmDock connectors now fall back to the agent's selected marketplace wallet when no connector-level wallet address is configured
+- **Task filter fix**: The built-in `swarmdock` tool now uses the correct `skills=` task filter when browsing marketplace tasks from chat
+- **SwarmDock SDK bump**: Updated `@swarmdock/sdk` from `0.5.2` to `0.5.3`, aligning the connector with the published metadata-sync fixes
+
 ### v1.4.5 Highlights
 
 - **OpenClaw 2026.4.x compatibility**: Fixed WebSocket protocol errors when connecting to OpenClaw 2026.4.2+ gateways (`profileId` was incorrectly included in RPC params)
@@ -320,7 +334,9 @@ Then open `http://localhost:3456`.
 
 ## Core Capabilities
 
-- **Providers**: OpenClaw, OpenAI, Anthropic, Ollama, Google, DeepSeek, Groq, Together, Mistral, xAI, Fireworks, Nebius, DeepInfra, plus compatible custom endpoints.
+- **Providers**: OpenClaw, OpenAI, OpenRouter, Anthropic, Ollama, Hermes Agent, Google, DeepSeek, Groq, Together, Mistral, xAI, Fireworks, Nebius, DeepInfra, plus compatible custom endpoints.
+- **OpenRouter**: <img src="public/provider-logos/openrouter.png" alt="OpenRouter logo" width="20" height="20" /> Use OpenRouter as a first-class built-in provider with its standard OpenAI-compatible endpoint and routed model IDs such as `openai/gpt-4.1-mini`.
+- **Hermes Agent**: <img src="public/provider-logos/hermes-agent.png" alt="Hermes Agent logo" width="20" height="20" /> Connect Hermes through its OpenAI-compatible API server, locally or through a reachable remote `/v1` endpoint.
 - **Delegation**: built-in delegation to Claude Code, Codex CLI, OpenCode CLI, Gemini CLI, and native SwarmClaw subagents.
 - **Autonomy**: heartbeat loops, schedules, background jobs, task execution, supervisor recovery, and agent wakeups.
 - **Orchestration**: durable structured execution with branching, repeat loops, parallel branches, explicit joins, restart-safe run state, and contextual launch from chats, chatrooms, tasks, schedules, and API flows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "description": "Self-hosted AI runtime for OpenClaw, delegation, autonomy, runtime skills, crypto wallets, and chat platform connectors.",
   "license": "MIT",
   "publishConfig": {

package/src/app/api/setup/check-provider/route.ts

@@ -7,6 +7,7 @@ import { normalizeOllamaSetupEndpoint, normalizeOpenClawUrl, parseErrorMessage }
 
 type SetupProvider =
   | 'openai'
+  | 'openrouter'
   | 'anthropic'
   | 'google'
   | 'deepseek'
@@ -19,6 +20,7 @@ type SetupProvider =
   | 'deepinfra'
   | 'ollama'
   | 'openclaw'
+  | 'hermes'
 
 interface SetupCheckBody {
   provider?: string
@@ -46,13 +48,14 @@ async function checkOpenAiCompatible(
   modelHint?: string,
 ): Promise<{ ok: boolean; message: string; normalizedEndpoint: string }> {
   const normalizedEndpoint = (endpointRaw || defaultEndpoint).replace(/\/+$/, '')
+  const authHeaders = apiKey ? { authorization: `Bearer ${apiKey}` } : undefined
 
   // First, discover a model to test with (prefer the hint, fall back to the first available model)
   let testModel = modelHint || ''
   if (!testModel) {
     try {
       const modelsRes = await fetch(`${normalizedEndpoint}/models`, {
-        headers: { authorization: `Bearer ${apiKey}` },
+        headers: authHeaders,
         signal: AbortSignal.timeout(8_000),
         cache: 'no-store',
       })
@@ -79,6 +82,8 @@ async function checkOpenAiCompatible(
       'Fireworks AI': 'accounts/fireworks/models/llama4-scout-instruct-basic',
       Nebius: 'deepseek-ai/DeepSeek-R1-0528',
       DeepInfra: 'deepseek-ai/DeepSeek-R1-0528',
+      OpenRouter: 'openai/gpt-4.1-mini',
+      'Hermes Agent': 'hermes-agent',
     }
     testModel = fallbacks[providerName] || 'gpt-4o-mini'
   }
@@ -87,8 +92,8 @@ async function checkOpenAiCompatible(
   const res = await fetch(`${normalizedEndpoint}/chat/completions`, {
     method: 'POST',
     headers: {
-      authorization: `Bearer ${apiKey}`,
       'content-type': 'application/json',
+      ...(authHeaders || {}),
     },
     body: JSON.stringify({
       model: testModel,
@@ -294,6 +299,12 @@ export async function POST(req: Request) {
         const result = await checkOpenAiCompatible(info.name, apiKey, endpoint, info.defaultEndpoint, model)
         return NextResponse.json(result)
       }
+      case 'openrouter': {
+        if (!apiKey) return NextResponse.json({ ok: false, message: 'OpenRouter API key is required.' })
+        const info = OPENAI_COMPATIBLE_DEFAULTS.openrouter
+        const result = await checkOpenAiCompatible(info.name, apiKey, endpoint, info.defaultEndpoint, model)
+        return NextResponse.json(result)
+      }
       case 'anthropic': {
         if (!apiKey) return NextResponse.json({ ok: false, message: 'Anthropic API key is required.' })
         const result = await checkAnthropic(apiKey, model)
@@ -313,6 +324,11 @@ export async function POST(req: Request) {
         const result = await checkOpenAiCompatible(info.name, apiKey, endpoint, info.defaultEndpoint, model)
         return NextResponse.json(result)
       }
+      case 'hermes': {
+        const info = OPENAI_COMPATIBLE_DEFAULTS.hermes
+        const result = await checkOpenAiCompatible(info.name, apiKey, endpoint, info.defaultEndpoint, model)
+        return NextResponse.json(result)
+      }
       case 'ollama': {
         const result = await checkOllama({
           endpointRaw: endpoint,

package/src/components/agents/agent-sheet.tsx

@@ -35,6 +35,7 @@ const HB_PRESETS = [1800, 3600, 7200, 21600, 43200] as const
 const FALLBACK_ELEVENLABS_VOICE_ID = 'JBFqnCBsd6RMkjVDRZzb'
 const AUTO_SYNC_MODEL_PROVIDER_IDS = new Set<ProviderType>([
   'openai',
+  'openrouter',
   'anthropic',
   'google',
   'deepseek',
@@ -45,6 +46,7 @@ const AUTO_SYNC_MODEL_PROVIDER_IDS = new Set<ProviderType>([
   'fireworks',
   'nebius',
   'deepinfra',
+  'hermes',
   'ollama',
 ])
 const CONNECTION_TEST_TIMEOUT_MS = 40_000
@@ -1645,13 +1647,16 @@ export function AgentSheet() {
         </div>
       )}
 
-      {currentProvider?.requiresEndpoint && (provider === 'openclaw' || (provider === 'ollama' && ollamaMode === 'local')) && (
+      {currentProvider?.requiresEndpoint && (provider !== 'ollama' || ollamaMode === 'local') && (
         <div className="mb-8">
-          <SectionLabel>{provider === 'openclaw' ? 'OpenClaw Endpoint' : 'Endpoint'}</SectionLabel>
+          <SectionLabel>{provider === 'openclaw' ? 'OpenClaw Endpoint' : provider === 'hermes' ? 'Hermes API Endpoint' : 'Endpoint'}</SectionLabel>
           <input type="text" value={apiEndpoint || ''} onChange={(e) => setApiEndpoint(e.target.value || null)} placeholder={currentProvider.defaultEndpoint || 'http://localhost:11434'} className={`${inputClass} font-mono text-[14px]`} />
           {provider === 'openclaw' && (
             <p className="text-[13px] text-text-3/70 mt-2">The URL of your OpenClaw gateway</p>
           )}
+          {provider === 'hermes' && (
+            <p className="text-[13px] text-text-3/70 mt-2">Point this at the Hermes API server, usually <code className="text-text-2">http://127.0.0.1:8642/v1</code>.</p>
+          )}
         </div>
       )}
 
@@ -2502,7 +2507,9 @@ export function AgentSheet() {
               ? 'Claude CLI uses its own built-in capabilities — no additional local tool/platform configuration is needed.'
               : provider === 'codex-cli'
                 ? 'OpenAI Codex CLI uses its own built-in tools (shell, files, etc.) — no additional local tool configuration needed.'
-                : 'OpenCode CLI uses its own built-in tools (shell, files, etc.) — no additional local tool configuration needed.'}
+                : provider === 'hermes'
+                  ? 'Hermes Agent runs behind its own API server and tool runtime. SwarmClaw sends prompts to Hermes directly instead of injecting local platform tools.'
+                  : 'OpenCode CLI uses its own built-in tools (shell, files, etc.) — no additional local tool configuration needed.'}
           </p>
         </div>
       )}

package/src/components/auth/setup-wizard/step-connect.tsx

@@ -329,6 +329,12 @@ export function StepConnect({
                 <p className="text-[12px] text-text-3">Remote example: <code className="text-text-2">https://your-gateway.ts.net/v1</code>.</p>
               </div>
             )}
+            {provider === 'hermes' && (
+              <div className="mt-2 space-y-0.5">
+                <p className="text-[12px] text-text-3">Hermes Agent&apos;s API server defaults to <code className="text-text-2">http://127.0.0.1:8642/v1</code>.</p>
+                <p className="text-[12px] text-text-3">Use any reachable local or remote API-server endpoint exposed by Hermes.</p>
+              </div>
+            )}
           </div>
         )}
 

package/src/components/auth/setup-wizard/utils.test.ts

@@ -265,4 +265,6 @@ test('requiresSetupProviderVerification skips custom providers', () => {
   assert.equal(requiresSetupProviderVerification('custom'), false)
   assert.equal(requiresSetupProviderVerification('openclaw'), false)
   assert.equal(requiresSetupProviderVerification('openai'), true)
+  assert.equal(requiresSetupProviderVerification('openrouter'), true)
+  assert.equal(requiresSetupProviderVerification('hermes'), true)
 })

package/src/lib/app/view-constants.ts

@@ -131,7 +131,7 @@ export const VIEW_EMPTY_STATES: Record<Exclude<AppView, 'agents' | 'home'>, { ic
     icon: 'zap',
     title: 'Providers',
     description: 'Manage LLM providers including built-in and custom OpenAI-compatible endpoints.',
-    features: ['Built-in support for Claude, OpenAI, Anthropic, and Ollama', 'Add custom OpenAI-compatible providers (OpenRouter, Together, Groq)', 'Configure base URLs, models, and API keys per provider', 'Custom providers work seamlessly with all features'],
+    features: ['Built-in support for OpenAI, OpenRouter, Anthropic, Ollama, Hermes Agent, and CLI runtimes', 'Add custom OpenAI-compatible providers for local or internal gateways', 'Configure base URLs, models, and API keys per provider', 'Built-in and custom providers work seamlessly with all features'],
   },
   skills: {
     icon: 'book',

package/src/lib/orchestrator-config.test.ts

@@ -6,6 +6,7 @@ describe('orchestrator-config', () => {
   it('marks CLI and OpenClaw providers as ineligible', () => {
     assert.equal(isOrchestratorProviderEligible('openai'), true)
     assert.equal(isOrchestratorProviderEligible('openclaw'), false)
+    assert.equal(isOrchestratorProviderEligible('hermes'), false)
     assert.equal(isOrchestratorProviderEligible('codex-cli'), false)
   })
 

package/src/lib/orchestrator-config.ts

@@ -5,6 +5,7 @@ export const NON_ORCHESTRATOR_PROVIDERS = new Set([
   'codex-cli',
   'opencode-cli',
   'openclaw',
+  'hermes',
 ])
 
 export type OrchestratorGovernance = 'autonomous' | 'approval-required' | 'notify-only'

package/src/lib/provider-sets.ts

@@ -1,8 +1,11 @@
 /** CLI providers that use their own tool execution outside the shared tool-runtime path. */
 export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli'])
 
-/** Providers with native tool/capability support (CLI providers + OpenClaw). */
-export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw'])
+/** Providers that manage their own runtime/tool loop even when reached over an API endpoint. */
+export const RUNTIME_MANAGED_PROVIDER_IDS = new Set(['hermes'])
+
+/** Providers with native tool/capability support (CLI providers + OpenClaw + Hermes). */
+export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw', 'hermes'])
 
 /** Providers that can only act as workers — no coordinator role, no heartbeat, no advanced settings. */
-export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw'])
+export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw', 'hermes'])

package/src/lib/providers/index.ts

@@ -71,6 +71,23 @@ export const PROVIDERS: Record<string, BuiltinProviderConfig> = {
     requiresEndpoint: false,
     handler: { streamChat: streamOpenAiChat },
   },
+  openrouter: {
+    id: 'openrouter',
+    name: 'OpenRouter',
+    models: ['openai/gpt-4.1-mini'],
+    requiresApiKey: true,
+    requiresEndpoint: false,
+    defaultEndpoint: 'https://openrouter.ai/api/v1',
+    handler: {
+      streamChat: (opts) => {
+        const patchedSession = {
+          ...opts.session,
+          apiEndpoint: opts.session.apiEndpoint || 'https://openrouter.ai/api/v1',
+        }
+        return streamOpenAiChat({ ...opts, session: patchedSession })
+      },
+    },
+  },
   anthropic: {
     id: 'anthropic',
     name: 'Anthropic',
@@ -89,6 +106,24 @@ export const PROVIDERS: Record<string, BuiltinProviderConfig> = {
     defaultEndpoint: 'http://localhost:18789',
     handler: { streamChat: streamOpenClawChat },
   },
+  hermes: {
+    id: 'hermes',
+    name: 'Hermes Agent',
+    models: ['hermes-agent'],
+    requiresApiKey: false,
+    optionalApiKey: true,
+    requiresEndpoint: true,
+    defaultEndpoint: 'http://127.0.0.1:8642/v1',
+    handler: {
+      streamChat: (opts) => {
+        const patchedSession = {
+          ...opts.session,
+          apiEndpoint: opts.session.apiEndpoint || 'http://127.0.0.1:8642/v1',
+        }
+        return streamOpenAiChat({ ...opts, session: patchedSession })
+      },
+    },
+  },
   'opencode-cli': {
     id: 'opencode-cli',
     name: 'OpenCode CLI',

package/src/lib/providers/openai.ts

@@ -73,6 +73,10 @@ export function streamOpenAiChat({ session, message, imagePath, imageUrl, apiKey
           // Try with stream_options first; if the provider rejects with 400, retry without it
           let res: Response | undefined
           let usageEnabled = true
+          const headers: Record<string, string> = {
+            'Content-Type': contentType,
+          }
+          if (apiKey) headers.Authorization = `Bearer ${apiKey}`
           for (const includeStreamOptions of [true, false]) {
             const payloadObj: Record<string, unknown> = {
               model,
@@ -86,10 +90,7 @@ export function streamOpenAiChat({ session, message, imagePath, imageUrl, apiKey
 
             res = await fetch(url, {
               method: 'POST',
-              headers: {
-                'Authorization': `Bearer ${apiKey}`,
-                'Content-Type': contentType,
-              },
+              headers,
               body: payload,
               signal: abortController.signal,
             })

package/src/lib/server/agents/agent-availability.ts

@@ -27,6 +27,6 @@ export function buildWorkerOnlyAgentMessage(
   const name = typeof agent?.name === 'string' && agent.name.trim()
     ? agent.name.trim()
     : 'This agent'
-  if (action) return `${name} is a CLI-based agent and cannot ${action}. CLI agents can only be used for direct chats and delegation.`
-  return `${name} is a CLI-based agent and cannot join chatrooms. CLI agents can only be used for direct chats and delegation.`
+  if (action) return `${name} uses a runtime-managed provider and cannot ${action}. Runtime-managed agents can only be used for direct chats and delegation.`
+  return `${name} uses a runtime-managed provider and cannot join chatrooms. Runtime-managed agents can only be used for direct chats and delegation.`
 }

package/src/lib/server/chat-execution/chat-turn-preparation.ts

@@ -44,7 +44,7 @@ import {
   splitCapabilityIds,
 } from '@/lib/capability-selection'
 import { normalizeProviderEndpoint, isLocalOpenClawEndpoint } from '@/lib/openclaw/openclaw-endpoint'
-import { NON_LANGGRAPH_PROVIDER_IDS } from '@/lib/provider-sets'
+import { NON_LANGGRAPH_PROVIDER_IDS, RUNTIME_MANAGED_PROVIDER_IDS } from '@/lib/provider-sets'
 import {
   bridgeHumanReplyFromChat,
 } from '@/lib/server/chatrooms/session-mailbox'
@@ -815,9 +815,11 @@ export async function prepareChatTurn(input: ExecuteChatTurnInput): Promise<Prep
   const hideAssistantTranscript = internal && source === 'main-loop-followup'
 
   const useLocalOpenClawNativeRuntime = providerType === 'openclaw' && isLocalOpenClawEndpoint(sessionForRun.apiEndpoint)
+  const useProviderManagedRuntime = RUNTIME_MANAGED_PROVIDER_IDS.has(providerType)
   const enabledSessionExtensions = getEnabledCapabilityIds(sessionForRun)
   const hasExtensions = enabledSessionExtensions.length > 0
     && !NON_LANGGRAPH_PROVIDER_IDS.has(providerType)
+    && !useProviderManagedRuntime
     && !useLocalOpenClawNativeRuntime
 
   const systemPrompt = heartbeatLightContext

package/src/lib/server/provider-health.test.ts

@@ -120,6 +120,7 @@ describe('provider-health', () => {
   it('OPENAI_COMPATIBLE_DEFAULTS has expected providers', () => {
     const defaults = providerHealth.OPENAI_COMPATIBLE_DEFAULTS
     assert.ok(defaults.openai)
+    assert.ok(defaults.openrouter)
     assert.ok(defaults.google)
     assert.ok(defaults.deepseek)
     assert.ok(defaults.groq)
@@ -127,11 +128,17 @@ describe('provider-health', () => {
     assert.ok(defaults.mistral)
     assert.ok(defaults.xai)
     assert.ok(defaults.fireworks)
+    assert.ok(defaults.hermes)
 
     // Each entry has name and defaultEndpoint
-    for (const [, val] of Object.entries(defaults)) {
+    for (const [key, val] of Object.entries(defaults)) {
       assert.ok(typeof val.name === 'string' && val.name.length > 0)
-      assert.ok(typeof val.defaultEndpoint === 'string' && val.defaultEndpoint.startsWith('https://'))
+      assert.ok(typeof val.defaultEndpoint === 'string' && val.defaultEndpoint.length > 0)
+      if (key === 'hermes') {
+        assert.ok(val.defaultEndpoint.startsWith('http://'))
+      } else {
+        assert.ok(val.defaultEndpoint.startsWith('https://'))
+      }
     }
   })
 

package/src/lib/server/provider-health.ts

@@ -246,6 +246,7 @@ async function parseErrorMessage(res: Response, fallback: string): Promise<strin
 
 export const OPENAI_COMPATIBLE_DEFAULTS: Record<string, { name: string; defaultEndpoint: string }> = {
   openai: { name: 'OpenAI', defaultEndpoint: 'https://api.openai.com/v1' },
+  openrouter: { name: 'OpenRouter', defaultEndpoint: 'https://openrouter.ai/api/v1' },
   google: { name: 'Google Gemini', defaultEndpoint: 'https://generativelanguage.googleapis.com/v1beta/openai' },
   deepseek: { name: 'DeepSeek', defaultEndpoint: 'https://api.deepseek.com/v1' },
   groq: { name: 'Groq', defaultEndpoint: 'https://api.groq.com/openai/v1' },
@@ -255,15 +256,18 @@ export const OPENAI_COMPATIBLE_DEFAULTS: Record<string, { name: string; defaultE
   fireworks: { name: 'Fireworks AI', defaultEndpoint: 'https://api.fireworks.ai/inference/v1' },
   nebius: { name: 'Nebius', defaultEndpoint: 'https://api.tokenfactory.nebius.com/v1' },
   deepinfra: { name: 'DeepInfra', defaultEndpoint: 'https://api.deepinfra.com/v1/openai' },
+  hermes: { name: 'Hermes Agent', defaultEndpoint: 'http://127.0.0.1:8642/v1' },
 }
 
 export async function pingOpenAiCompatible(
-  apiKey: string,
+  apiKey: string | undefined,
   endpoint: string,
 ): Promise<{ ok: boolean; message: string }> {
   const normalizedEndpoint = endpoint.replace(/\/+$/, '')
+  const headers: Record<string, string> = {}
+  if (apiKey) headers.authorization = `Bearer ${apiKey}`
   const res = await fetch(`${normalizedEndpoint}/models`, {
-    headers: { authorization: `Bearer ${apiKey}` },
+    headers: Object.keys(headers).length > 0 ? headers : undefined,
     signal: AbortSignal.timeout(PING_TIMEOUT_MS),
     cache: 'no-store',
   })
@@ -335,6 +339,7 @@ export async function pingProvider(
   endpoint: string | undefined,
 ): Promise<{ ok: boolean; message: string }> {
   const CLI_PROVIDERS = ['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli']
+  const OPTIONAL_OPENAI_COMPATIBLE_KEY_PROVIDERS = new Set(['hermes'])
   if (CLI_PROVIDERS.includes(provider)) return { ok: true, message: 'CLI provider — skipped.' }
 
   try {
@@ -352,7 +357,7 @@ export async function pingProvider(
     const defaults = OPENAI_COMPATIBLE_DEFAULTS[provider]
     const resolvedEndpoint = endpoint || defaults?.defaultEndpoint
     if (!resolvedEndpoint) return { ok: false, message: `No endpoint for provider "${provider}".` }
-    if (!apiKey) return { ok: false, message: 'No API key configured.' }
+    if (!apiKey && !OPTIONAL_OPENAI_COMPATIBLE_KEY_PROVIDERS.has(provider)) return { ok: false, message: 'No API key configured.' }
     return await pingOpenAiCompatible(apiKey, resolvedEndpoint)
   } catch (err: unknown) {
     const msg = err instanceof Error && err.name === 'TimeoutError'

package/src/lib/server/provider-model-discovery.test.ts

@@ -208,6 +208,26 @@ test('resolveDescriptor uses explicit cloud Ollama discovery only when cloud mod
   assert.equal(descriptor?.requiresApiKey, true)
 })
 
+test('resolveDescriptor uses OpenRouter as an OpenAI-compatible provider', () => {
+  const descriptor = resolveDescriptor({
+    providerId: 'openrouter',
+  })
+  assert.equal(descriptor?.strategy, 'openai-compatible')
+  assert.equal(descriptor?.endpoint, 'https://openrouter.ai/api/v1')
+  assert.equal(descriptor?.requiresApiKey, true)
+  assert.equal(descriptor?.optionalApiKey, false)
+})
+
+test('resolveDescriptor uses Hermes as an OpenAI-compatible provider with optional auth', () => {
+  const descriptor = resolveDescriptor({
+    providerId: 'hermes',
+  })
+  assert.equal(descriptor?.strategy, 'openai-compatible')
+  assert.equal(descriptor?.endpoint, 'http://127.0.0.1:8642/v1')
+  assert.equal(descriptor?.requiresApiKey, false)
+  assert.equal(descriptor?.optionalApiKey, true)
+})
+
 // ---------------------------------------------------------------------------
 // ttlForDescriptor
 // ---------------------------------------------------------------------------

package/src/lib/server/storage.ts

@@ -669,7 +669,7 @@ if (!IS_BUILD_BOOTSTRAP) {
 ## Platform
 
 - **Agents** — Create specialized AI agents (Agents tab → "+") with a provider, model, system prompt, and tools. "Generate with AI" scaffolds agents from a description. Enable cross-agent delegation when an agent should assign work to others.
-- **Providers** — Configure LLM backends in Settings → Providers: Claude Code CLI, OpenAI Codex CLI, OpenCode CLI, Anthropic, OpenAI, Google Gemini, DeepSeek, Groq, Together AI, Mistral AI, xAI (Grok), Fireworks AI, Ollama, OpenClaw, or custom OpenAI-compatible endpoints.
+- **Providers** — Configure LLM backends in Settings → Providers: Claude Code CLI, OpenAI Codex CLI, OpenCode CLI, Gemini CLI, GitHub Copilot CLI, Anthropic, OpenAI, OpenRouter, Google Gemini, DeepSeek, Groq, Together AI, Mistral AI, xAI (Grok), Fireworks AI, Nebius, DeepInfra, Ollama, OpenClaw, Hermes Agent, or custom OpenAI-compatible endpoints.
 - **Tasks** — The Task Board tracks work items. Assign agents and they'll execute autonomously.
 - **Schedules** — Cron-based recurring jobs that run agents or tasks automatically.
 - **Skills** — Reusable markdown instruction files agents can discover and use by default; pin them to keep favorite workflows always-on.

package/src/lib/setup-defaults.test.ts

@@ -27,11 +27,21 @@ test('getDefaultModelForProvider returns non-empty for openai', () => {
   assert.ok(model, 'openai model should be truthy')
 })
 
+test('getDefaultModelForProvider returns non-empty for openrouter', () => {
+  const model = getDefaultModelForProvider('openrouter')
+  assert.ok(model, 'openrouter model should be truthy')
+})
+
 test('getDefaultModelForProvider returns non-empty for anthropic', () => {
   const model = getDefaultModelForProvider('anthropic')
   assert.ok(model, 'anthropic model should be truthy')
 })
 
+test('getDefaultModelForProvider returns non-empty for hermes', () => {
+  const model = getDefaultModelForProvider('hermes')
+  assert.ok(model, 'hermes model should be truthy')
+})
+
 test('getDefaultModelForProvider returns non-empty for ollama', () => {
   const model = getDefaultModelForProvider('ollama')
   assert.ok(model, 'ollama model should be truthy')

package/src/lib/setup-defaults.ts

@@ -6,6 +6,7 @@
 export type SetupProvider =
   | 'anthropic'
   | 'openai'
+  | 'openrouter'
   | 'google'
   | 'deepseek'
   | 'groq'
@@ -17,6 +18,7 @@ export type SetupProvider =
   | 'deepinfra'
   | 'ollama'
   | 'openclaw'
+  | 'hermes'
   | 'custom'
 
 export interface SetupProviderOption {
@@ -52,6 +54,19 @@ export const SETUP_PROVIDERS: SetupProviderOption[] = [
     icon: 'O',
     modelLibraryUrl: 'https://platform.openai.com/docs/models',
   },
+  {
+    id: 'openrouter',
+    name: 'OpenRouter',
+    description: 'One API key for a broad multi-provider model catalog through an OpenAI-compatible API.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    defaultEndpoint: 'https://openrouter.ai/api/v1',
+    keyUrl: 'https://openrouter.ai/keys',
+    keyLabel: 'openrouter.ai',
+    badge: 'Catalog',
+    icon: 'R',
+    modelLibraryUrl: 'https://openrouter.ai/models',
+  },
   {
     id: 'openclaw',
     name: 'OpenClaw',
@@ -64,6 +79,18 @@ export const SETUP_PROVIDERS: SetupProviderOption[] = [
     badge: 'First-Tier',
     icon: 'C',
   },
+  {
+    id: 'hermes',
+    name: 'Hermes Agent',
+    description: 'Connect Hermes Agent through its local or remote OpenAI-compatible API server runtime.',
+    requiresKey: false,
+    supportsEndpoint: true,
+    allowMultiple: true,
+    defaultEndpoint: 'http://127.0.0.1:8642/v1',
+    optionalKey: true,
+    badge: 'API Server',
+    icon: 'H',
+  },
   {
     id: 'anthropic',
     name: 'Anthropic',
@@ -192,7 +219,7 @@ export const SETUP_PROVIDERS: SetupProviderOption[] = [
   {
     id: 'custom',
     name: 'Custom Provider',
-    description: 'Any OpenAI-compatible API endpoint (OpenRouter, LM Studio, vLLM, etc.).',
+    description: 'Any OpenAI-compatible API endpoint (LM Studio, vLLM, local gateways, etc.).',
     requiresKey: false,
     supportsEndpoint: true,
     allowMultiple: true,
@@ -598,6 +625,13 @@ export const DEFAULT_AGENTS: Record<SetupProvider, DefaultAgentConfig> = {
     model: 'gpt-4o',
     tools: STARTER_AGENT_TOOLS,
   },
+  openrouter: {
+    name: 'Router',
+    description: 'A helpful assistant powered through OpenRouter.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'openai/gpt-4.1-mini',
+    tools: STARTER_AGENT_TOOLS,
+  },
   google: {
     name: 'Gemini',
     description: 'A helpful Gemini-powered assistant.',
@@ -675,6 +709,13 @@ export const DEFAULT_AGENTS: Record<SetupProvider, DefaultAgentConfig> = {
     model: '',
     tools: STARTER_AGENT_TOOLS,
   },
+  hermes: {
+    name: 'Hermes',
+    description: 'A runtime-backed assistant powered by Hermes Agent.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'hermes-agent',
+    tools: STARTER_AGENT_TOOLS,
+  },
   custom: {
     name: 'Custom Agent',
     description: 'An assistant powered by a custom OpenAI-compatible provider.',

package/src/types/provider.ts

@@ -1,4 +1,4 @@
-export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'copilot-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks' | 'nebius' | 'deepinfra'
+export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'copilot-cli' | 'openai' | 'openrouter' | 'ollama' | 'anthropic' | 'openclaw' | 'hermes' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks' | 'nebius' | 'deepinfra'
 export type ProviderId = ProviderType | (string & {})
 
 export interface ProviderInfo {