Configure OpenClaw

Choose the upstream protocol, add models, and manage default model, environment, and tool permissions.

OpenClaw providers live under models.providers.<id> in openclaw.json. It keeps several providers at once, so every Provider ID must be unique. OcHub does not manage OpenClaw MCP or skills. Its default directory is ~/.openclaw.

Configure the connection and models

Choose the actual upstream protocol:
- openai-completions
- openai-responses
- anthropic-messages
- google-generative-ai
- bedrock-converse-stream
Enter Base URL and API key.
Add model ID, display name, context window, and reasoning marker.
Add custom headers only for required tenant or routing information.
Confirm the provider appears under the right ID and save.

The protocol is required. A correct key with the wrong protocol commonly produces a 404, invalid request body, or broken streaming.

Default model, environment, and tool permissions

Under Advanced tools → OpenClaw advanced configuration:

Area	Content	Typical use
Default model JSON	`agents.defaults.model`	`primary`, `fallbacks`, and related fields
Environment JSON	`env`	Runtime key-value pairs
Tool configuration JSON	`tools`	`profile`, `allow`, and `deny`

Run Check OpenClaw configuration first. JSON values must have the right object, array, and string types. Record the backup path OcHub reports when saving.

After saving, follow the verification checklist to confirm the new connection works.