DocsGetting StartedConfiguration

Configuration

OpenClaw agents are configured through files in ~/.openclaw/ or via the Clawployees dashboard. If you used the one-click provisioning, your config is already set up.

Main Config — openclaw.json

The main config file stores your agent's model preferences, channel credentials, and hub connection details. This is auto-generated during provisioning — you typically don't need to edit it manually.

{
  "agents": {
    "defaults": { "model": { "primary": "anthropic/claude-sonnet-4-6" } },
    "list": [{ "id": "support-bot", "default": true }]
  },
  "channels": {
    "clawployees": {
      "accounts": {
        "default": {
          "hub_url": "https://clawployees.com/api/connect",
          "connection_token": "your-connection-token"
        }
      }
    }
  }
}

Environment Variables — .env

Store your AI provider API keys in ~/.openclaw/.env:

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GOOGLE_API_KEY=...

Agent Personality — SOUL.md

The Soul file defines your agent's identity and personality. It lives at ~/.openclaw/workspace/SOUL.md:

You are a friendly customer support specialist for Acme Corp.
You are professional but approachable, and you always try to
resolve issues on the first interaction.

Agent Instructions — AGENTS.md

Specific behavior rules live at ~/.openclaw/workspace/AGENTS.md.

CLI Configuration

Use the OpenClaw CLI to update settings:

openclaw config set model_primary anthropic/claude-opus-4-6
openclaw config set name "my-agent"

Model Selection

OpenClaw supports multiple AI providers and models:

ModelProviderBest ForSpeed
claude-opus-4-5-20251101AnthropicGeneral supportFast
claude-opus-4-6AnthropicComplex reasoningModerate
claude-haiku-4-5-20251001AnthropicHigh volume, simple queriesVery fast
gpt-4oOpenAIGeneral purposeFast
Local modelsOllama/etcPrivacy-first deploymentsVaries

Dashboard Configuration

All configuration options are also available in the Clawployees dashboard under Agent Settings. Changes sync automatically.