Use OpenClaw with Your Model

OpenClaw configuration can change between releases. Check the current OpenClaw documentation for the exact configuration file location used by your installed version.

The first-version Your Model setup uses OpenAI-compatible Chat Completions:

{
  models: {
    mode: 'merge',
    providers: {
      yourmodel: {
        baseUrl: 'https://y-models.com/v1',
        apiKey: '${YOURMODEL_API_KEY}',
        api: 'openai-completions',
        models: [
          {
            id: 'YOUR_MODEL_ID',
            name: 'Your Model',
          },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: 'yourmodel/YOUR_MODEL_ID',
      },
    },
  },
}

Important details:

• The Base URL must include /v1.
• The model ID must exactly match /v1/models.
• openai-completions is the default first-version route.
• Switch to openai-responses only after Responses API compatibility is verified for the model you use.
• Store the API key in an environment variable.

If available in your OpenClaw version, check configured models with:

openclaw models list