OpenClaw Integration

OpenClaw is a self-hosted gateway that connects your favorite chat apps—WhatsApp, Telegram, Discord, iMessage, and more—to AI coding agents. With OffRail as a custom provider, you can route all your OpenClaw traffic through a single API, use any of 200+ models, and keep full visibility into usage and costs.

Setup

export OFFRAIL_API_KEY=orl_your_api_key_here

{
	"models": {
		"mode": "merge",
		"providers": {
			"offrail": {
				"baseUrl": "https://api.offrail.ai/v1",
				"apiKey": "${OFFRAIL_API_KEY}",
				"api": "openai-completions",
				"models": [
					{
						"id": "gpt-5.4",
						"name": "GPT-5.4",
						"contextWindow": 128000,
						"maxTokens": 32000
					},
					{
						"id": "claude-opus-4-6",
						"name": "Claude Opus 4.6",
						"contextWindow": 200000,
						"maxTokens": 8192
					},
					{
						"id": "gemini-3.1-pro-preview",
						"name": "Gemini 3.1 Pro",
						"contextWindow": 1000000,
						"maxTokens": 8192
					}
				]
			}
		}
	},
	"agents": {
		"defaults": {
			"model": {
				"primary": "offrail/gpt-5.4"
			}
		}
	}
}

Why Use OffRail with OpenClaw

• Model flexibility — Switch between GPT-5.4, Claude Opus, Gemini, or any of 200+ models
• Cost tracking — Monitor exactly how much your chat agents cost to run
• Single bill — No need to manage multiple API provider accounts
• Response caching — Repeated queries hit cache, reducing costs
• Rate limit handling — Automatic fallback between providers

Switching Models

Change the primary model in your config to switch between any model:

{
	"agents": {
		"defaults": {
			"model": { "primary": "offrail/claude-opus-4-6" }
		}
	}
}

Model Fallback Chain

OpenClaw supports fallback models. If the primary model is unavailable, it automatically falls back:

{
	"agents": {
		"defaults": {
			"model": {
				"primary": "offrail/gpt-5.4",
				"fallbacks": ["offrail/claude-opus-4-6"]
			}
		}
	}
}

Available Models

OffRail uses canonical model IDs with smart routing—automatically selecting the best provider based on uptime, throughput, price, and latency. You can use any model from the models page. Flagship models include:

For more details on routing behavior, see routing.

Tips for Chat Agents

Optimize Costs

1. Use smaller models for simple tasks — Claude Haiku or Gemini Flash handle basic Q&A well
2. Enable caching — OffRail caches identical requests automatically
3. Set token limits — Configure max tokens to prevent runaway costs

Improve Response Quality

1. Choose the right model — Claude Opus excels at nuanced conversation, GPT-5.4 at general tasks
2. Use system prompts — Configure your agent's personality and capabilities
3. Test multiple models — OffRail makes it easy to A/B test different providers