Change OpenClaw’s Default Model Safely
Change the default model in the active OpenClaw configuration after confirming the model and authentication route you want. Test a fresh session before moving live traffic and verify existing chats or jobs separately if they matter to the rollout.
Choose how Claude should authenticate
For Claude, OpenClaw documents two options with different operational requirements. The Anthropic API route uses an API key and usage-based billing. The Claude CLI route can reuse an existing Claude Code login through the executable on the OpenClaw host. Choose the API route when you need API-account metering. Choose the CLI route when you intend to use the selected Claude Code account and can verify its access on that host.
Inspect the route shown by the picker before saving. For a native login, the web picker derives its billing label from Claude Code authentication status. Record the resolved account or billing label alongside the model reference so the next operator can reproduce the choice.
A saved configuration is an intermediate checkpoint. Verify the effective model on a fresh request from the intended gateway.
Anthropic - OpenClawCheck scheduled work before ending the rollout
After saving the new default, open a fresh chat and confirm that the intended model handles a known task. If an existing chat still resolves to a different route, inspect its session selection. Check any scheduled job that matters to the rollout as well. OpenClaw documents model settings on automation jobs, so inspect the affected job for an explicit model choice before treating its behavior as a gateway configuration problem.
If only one job should change, update that job's model setting within the agent's allowed policy and verify a representative run. If the new default fails the fresh-chat check, restore the recorded default and repeat the test. Confirm the recovered model and expected output before resuming traffic.
Keep the previous accepted output with the test input. A successful model selection and a quality regression can happen in the same trial.
Heartbeat migration - OpenClaw