Configuration
Configuring providers
Section titled “Configuring providers”Clawforce supports two levels of provider configuration:
- Global providers are created in Settings and available to every instance. This is the most common setup.
- Instance providers are created on an individual instance’s detail page and apply only to that instance. Use these when an instance needs its own API key or a provider that other instances should not access.
Both types work identically with the LLM gateway. Instance providers appear alongside global providers when you enable models on that instance.
Adding a global provider
Section titled “Adding a global provider”Go to Settings and find the Model API Keys section. Click Add Provider. A modal opens with two paths:
From the catalog — Select a known provider (Anthropic, OpenAI, Moonshot AI, and others) from the dropdown. Clawforce pre-fills the name and fetches the model list automatically from the Clawforce hosted catalog. You only need to supply your API key for that provider.
Custom — Select Custom from the dropdown to configure any provider manually, including self-hosted models (Ollama, vLLM, LM Studio) or any service with an OpenAI-compatible API. Fill in:
| Field | Description |
|---|---|
| Name | Display name shown in the dashboard |
| Base URL | Provider API base URL — see API types for the correct format per provider |
| API type | Request format the provider uses — controls auth headers and URL handling. |
| API key | Provider credential. Stored encrypted and shown masked (**** + last 4 characters) after saving. |
| Models | For custom providers: define each model with its ID, name, and optional metadata (context window, max tokens, cost rates) |
The provider key — a URL-safe slug like anthropic or my-ollama — is derived automatically from the name when you create the provider. It cannot be changed after creation.
API types
Section titled “API types”The api_type field controls which authentication header the gateway forwards and how it handles the base URL. Choose the type that matches your provider’s API format.
| API type | Typical providers | Auth sent upstream | Base URL format |
|---|---|---|---|
openai-completions | OpenAI, Together AI, OpenRouter, and any OpenAI-compatible API | Authorization: Bearer | Must end with /v1 — e.g. https://api.openai.com/v1 |
openai-responses | OpenAI Responses API | Authorization: Bearer | Must end with /v1 |
anthropic-messages | Anthropic | x-api-key | Root URL only — e.g. https://api.anthropic.com (no /v1) |
google-generative-ai | Google Gemini | x-goog-api-key | Include /v1beta — e.g. https://generativelanguage.googleapis.com/v1beta |
ollama | Ollama (self-hosted) | Authorization: Bearer (empty key accepted) | Root URL — e.g. http://localhost:11434 |
Base URL notes
Section titled “Base URL notes”anthropic-messages: set the root URL without/v1(e.g.https://api.anthropic.com). The Anthropic SDK appends/v1/messagesitself.google-generative-ai: include/v1betain the URL. The Google SDK omits the version segment when a custom base URL is provided, so you must include it explicitly.openai-completions/openai-responses: the URL must end with/v1. The gateway de-duplicates the segment if it is already present.ollama: an empty or missing API key is accepted — Ollama does not require authentication by default.
Any provider with an OpenAI-compatible /chat/completions endpoint can be added as a custom provider with api_type: openai-completions, regardless of whether it appears in the catalog.
Adding an instance provider
Section titled “Adding an instance provider”Open the instance detail page and go to the Enabled Models section. Click Add provider to open the same provider modal, but scoped to that instance. The provider and its API key are stored separately from global providers and are only available to that specific instance.
Instance providers are labeled with an Instance badge in the provider list to distinguish them from global ones. You can edit or delete an instance provider from the same location.
Syncing catalog models
Section titled “Syncing catalog models”For well-known providers, the model list is fetched from the Clawforce hosted catalog and cached locally. Click Sync Models to force a refresh of providers, models and prices.