APIClaw

Hermes Agent

Connect Hermes Agent to APIClaw through a custom OpenAI-compatible endpoint.

Prerequisites

  1. Create an API key in the API Keys dashboard.
  2. Copy a full model ID from the model hub.

Install

Follow the Hermes Agent install instructions for your platform, then verify:

bash
hermes --version

Configure with the wizard

bash
export APICLAW_API_KEY="sk-your-apiclaw-key"
hermes model

Choose a custom endpoint, then enter:

SettingValue
Base URLhttps://apiclaw.biz/v1
API keyYour APIClaw API key (or leave blank if stored in .env)
ModelFull model ID from the model hub

Configure ~/.hermes/config.yaml

yaml
model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://apiclaw.biz/v1
  api_key: sk-your-apiclaw-key

Prefer storing secrets in ~/.hermes/.env instead of committing keys into YAML.

SettingValue
model.providercustom
model.base_urlhttps://apiclaw.biz/v1
model.defaultFull model ID from the model hub

Verify

bash
hermes chat

Send a short prompt, then confirm the request in logs.

Troubleshooting

  • For provider: custom, set model.base_url. OPENAI_BASE_URL alone only affects the built-in openai-api path.
  • Stale entries in ~/.hermes/.env can override an updated YAML file; clean unused vars after migrations.