Corveil Docs

Appearance

OpenClaw ​

OpenClaw is an AI gateway client that supports custom provider routing with headers, making it ideal for Corveil's passthrough mode.

Prerequisites ​

  • A running Corveil instance (see deployment options)
  • A Corveil virtual API key (sk-citadel-...)
  • OpenClaw installed and running (openclaw gateway run or the Mac app)
  • An existing Anthropic API key or OAuth session configured in OpenClaw

Mode ​

Passthrough mode only. OpenClaw forwards your existing Anthropic credentials upstream. The x-citadel-api-key header authenticates with Corveil for tracking and guardrails.

1. Configure the Anthropic provider ​

bash
openclaw config set models.providers.anthropic '{
  "baseUrl": "https://your-corveil-host",
  "api": "anthropic-messages",
  "headers": {
    "x-citadel-api-key": "sk-citadel-your-key-here"
  },
  "models": [
    {
      "id": "claude-sonnet-4-6",
      "name": "Claude Sonnet 4.6",
      "reasoning": true,
      "input": ["text", "image"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 200000,
      "maxTokens": 16384
    }
  ]
}'

2. Restart the gateway ​

bash
# If using the Mac app, restart from the menu bar
# Otherwise:
openclaw gateway restart

3. Verify the connection ​

bash
openclaw channels status --probe
openclaw message send "Hello from OpenClaw via Corveil"

Troubleshooting ​

  • 401 Unauthorized from Corveil: Verify your x-citadel-api-key is valid and has not expired
  • 401 from upstream provider: Check that your Anthropic credentials are still configured in OpenClaw
  • Connection refused: Ensure your Corveil instance is running and the baseUrl is reachable