Using BytePlus with OpenClaw

Prerequisites

• ✓An existing OpenClaw project created from the official quickstart or install flow.
• ✓Access to at least one supported model provider account (for example Anthropic, OpenAI, or BytePlus (International) via the model providers page).
• ✓The OpenClaw CLI installed and available in your shell so you can run `openclaw onboard`.

Steps

1. 1

   Understand how OpenClaw selects a model provider

   OpenClaw always talks to models through a `provider/model` identifier, so you need to know this format before you plug in BytePlus. The provider directory makes it clear that you first pick a provider, authenticate, then set the default model string.

   This mental model helps you swap providers later without rewriting your agents.

   textCopy

   OpenClaw can use many LLM providers. Pick a provider, authenticate, then set the default model as `provider/model`.

2. 2

   Authenticate with a model provider using the CLI

   Before you can call any model, you need to authenticate with its provider using the OpenClaw CLI. The docs describe this as the first step in the quick start, and most providers follow the same `openclaw onboard` pattern.

   Run this from your project so OpenClaw can store credentials and test connectivity.

   textCopy

   1.   Authenticate with the provider (usually via `openclaw onboard`).

3. 3

   Set a default model for your agents

   Once a provider is onboarded, you tell OpenClaw which model to use by default for your agents. primary` to a `provider/model` string in your config.

   The example uses Anthropic, but you will swap that string to the BytePlus (International) model you want once you have its identifier.

   jsonCopy

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

4. 4

   Locate the BytePlus (International) provider details

   BytePlus (International) is documented alongside other providers on the model providers concept page. Use that page to find the exact `provider/model` name and any provider-specific onboarding flags you need.

   This keeps your OpenClaw config aligned with the provider’s actual API surface.

   textCopy

   *   [BytePlus (International)](https://docs.openclaw.ai/concepts/model-providers#byteplus-international)

5. 5

   Switch your default model to the BytePlus provider

   After you know the BytePlus `provider/model` string, update your agent defaults to point at it instead of the example Anthropic model. The structure of the config stays the same; only the `primary` value changes.

   This is how you move an existing OpenClaw agent over to BytePlus without touching channel or tool wiring.

   jsonCopy

   {
     agents: { defaults: { model: { primary: "provider/model" } } },
   }

Configuration

Troubleshooting

{
  agents: { defaults: { model: { primary: "provider/model" } } },
}

1.   Authenticate with the provider (usually via `openclaw onboard`).

Frequently asked questions