docs: document provider ids and auth contracts

This commit is contained in:
Shakker
2026-04-23 06:36:51 +01:00
committed by Shakker
parent db1e4f811d
commit bd4cfe0e7e
5 changed files with 92 additions and 81 deletions

View File

@@ -46,6 +46,9 @@ Notes:
- `models list --all` includes bundled provider-owned static catalog rows even
when you have not authenticated with that provider yet. Those rows still show
as unavailable until matching auth is configured.
- `models list --provider <id>` filters by provider id, such as `moonshot` or
`openai-codex`. It does not accept display labels from interactive provider
pickers, such as `Moonshot AI`.
- Model refs are parsed by splitting on the **first** `/`. If the model ID includes `/` (OpenRouter-style), include the provider prefix (example: `openrouter/moonshotai/kimi-k2`).
- If you omit the provider, OpenClaw resolves the input as an alias first, then
as a unique configured-provider match for that exact model id, and only then