Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw models
Modelontdekking, scanning en configuratie (standaardmodel, fallbacks, auth-profielen).
Gerelateerd:
- Providers + modellen: Modellen
- Concepten voor modelselectie + slashcommando
/models: Modellenconcept - Instellen van providerauthenticatie: Aan de slag
Veelgebruikte commando’s
openclaw models status toont de opgeloste standaardinstelling/fallbacks plus een auth-overzicht.
Wanneer snapshots van providergebruik beschikbaar zijn, bevat de statussectie voor OAuth/API-sleutels
vensters voor providergebruik en quotasnapshots.
Huidige providers met gebruiksvensters: Anthropic, GitHub Copilot, Gemini CLI, OpenAI
Codex, MiniMax, Xiaomi en z.ai. Gebruiksaanmelding komt uit provider-specifieke hooks
wanneer die beschikbaar zijn; anders valt OpenClaw terug op overeenkomende OAuth/API-sleutelreferenties
uit auth-profielen, env of configuratie.
In --json-uitvoer is auth.providers het provider-overzicht dat rekening houdt met env/config/store,
terwijl auth.oauth alleen de gezondheid van auth-store-profielen is.
Voeg --probe toe om live auth-probes uit te voeren tegen elk geconfigureerd providerprofiel.
Probes zijn echte aanvragen (kunnen tokens verbruiken en rate limits activeren).
Gebruik --agent <id> om de model-/authstatus van een geconfigureerde agent te inspecteren. Indien weggelaten,
gebruikt het commando OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR als die zijn ingesteld, anders de
geconfigureerde standaardagent.
Probe-rijen kunnen afkomstig zijn uit auth-profielen, env-referenties of models.json.
Opmerkingen:
models set <model-or-alias>accepteertprovider/modelof een alias.models listis alleen-lezen: het leest configuratie, auth-profielen, bestaande catalogusstatus en catalogusrijen van providers, maar herschrijftmodels.jsonniet.- De kolom
Authis op providerniveau en alleen-lezen. Deze wordt berekend uit lokale auth-profielmetadata, env-markeringen, geconfigureerde providersleutels, local-provider- markeringen, AWS Bedrock-env-/profielmarkeringen en synthetische-auth-metadata van plugins; de kolom laadt geen providerruntime, leest geen keychain-geheimen, roept geen provider- API’s aan en bewijst geen exacte uitvoeringsgereedheid per model. models list --all --provider <id>kan provider-eigen statische catalogusrijen bevatten uit pluginmanifesten of gebundelde providercatalogusmetadata, zelfs wanneer je je nog niet bij die provider hebt aangemeld. Die rijen worden nog steeds als niet beschikbaar weergegeven totdat overeenkomende auth is geconfigureerd.- Brede
models list --allvoegt manifestcatalogusrijen samen bovenop registryrijen zonder supplementhooks voor providerruntime te laden. Provider-gefilterde snelle manifestpaden gebruiken alleen providers die alsstaticzijn gemarkeerd; providers die alsrefreshablezijn gemarkeerd blijven registry-/cache-ondersteund en voegen manifestrijen toe als supplementen, terwijl providers die alsruntimezijn gemarkeerd op registry-/runtimeontdekking blijven. models listhoudt native modelmetadata en runtimecaps gescheiden. In tabeluitvoer toontCtxcontextTokens/contextWindowwanneer een effectieve runtimecap verschilt van het native contextvenster; JSON-rijen bevattencontextTokenswanneer een provider die cap aanbiedt.models list --provider <id>filtert op provider-id, zoalsmoonshotofopenai-codex. Het accepteert geen weergavelabels uit interactieve providerkiezers, zoalsMoonshot AI.- Modelrefs worden geparseerd door te splitsen op de eerste
/. Als de model-ID/bevat (OpenRouter-stijl), voeg dan het providerprefix toe (voorbeeld:openrouter/moonshotai/kimi-k2). - Als je de provider weglaat, lost OpenClaw de invoer eerst op als alias, daarna als een unieke match bij een geconfigureerde provider voor die exacte model-id, en pas daarna valt het terug op de geconfigureerde standaardprovider met een deprecatiewaarschuwing. Als die provider het geconfigureerde standaardmodel niet meer aanbiedt, valt OpenClaw terug op de eerste geconfigureerde provider/model in plaats van een verouderde verwijderde-providerstandaard te tonen.
models statuskanmarker(<value>)tonen in auth-uitvoer voor niet-geheime placeholders (bijvoorbeeldOPENAI_API_KEY,secretref-managed,minimax-oauth,oauth:chutes,ollama-local) in plaats van ze als geheimen te maskeren.
Modellenscan
models scan leest de openbare :free-catalogus van OpenRouter en rangschikt kandidaten voor
fallbackgebruik. De catalogus zelf is openbaar, dus scans met alleen metadata hebben geen
OpenRouter-sleutel nodig.
Standaard probeert OpenClaw tool- en afbeeldingsondersteuning te proben met live modelaanroepen.
Als er geen OpenRouter-sleutel is geconfigureerd, valt het commando terug op uitvoer met alleen metadata
en legt het uit dat :free-modellen nog steeds OPENROUTER_API_KEY vereisen voor
probes en inference.
Opties:
--no-probe(alleen metadata; geen config-/geheimenlookup)--min-params <b>--max-age-days <days>--provider <name>--max-candidates <n>--timeout <ms>(catalogusaanvraag en time-out per probe)--concurrency <n>--yes--no-input--set-default--set-image--json
--set-default en --set-image vereisen live probes; scanresultaten met alleen metadata
zijn informatief en worden niet toegepast op de configuratie.
Modellenstatus
Opties:--json--plain--check(exit 1=verlopen/ontbrekend, 2=verloopt binnenkort)--probe(live probe van geconfigureerde auth-profielen)--probe-provider <name>(probe één provider)--probe-profile <id>(herhaalbare of kommagescheiden profiel-id’s)--probe-timeout <ms>--probe-concurrency <n>--probe-max-tokens <n>--agent <id>(geconfigureerde agent-id; overschrijftOPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)
--json houdt stdout gereserveerd voor de JSON-payload. Diagnostiek voor auth-profielen, providers
en opstarten wordt naar stderr geleid, zodat scripts stdout direct kunnen pipen
naar tools zoals jq.
Probe-statuscategorieën:
okauthrate_limitbillingtimeoutformatunknownno_model
excluded_by_auth_order: er bestaat een opgeslagen profiel, maar explicieteauth.order.<provider>liet het weg, dus de probe rapporteert de uitsluiting in plaats van het te proberen.missing_credential,invalid_expires,expired,unresolved_ref: profiel is aanwezig maar niet geschikt/oplosbaar.no_model: providerauth bestaat, maar OpenClaw kon geen te proben modelkandidaat voor die provider oplossen.
Aliassen + fallbacks
Auth-profielen
models auth add is de interactieve auth-helper. Die kan een providerauthflow
starten (OAuth/API-sleutel) of je begeleiden naar handmatig tokenplakken, afhankelijk van de
provider die je kiest.
models auth login voert de authflow van een providerplugin uit (OAuth/API-sleutel). Gebruik
openclaw plugins list om te zien welke providers zijn geïnstalleerd.
Gebruik openclaw models auth --agent <id> <subcommand> om auth-resultaten naar een
specifieke geconfigureerde agentstore te schrijven. De bovenliggende vlag --agent wordt gerespecteerd door
add, login, setup-token, paste-token en login-github-copilot.
Voorbeelden:
setup-tokenenpaste-tokenblijven generieke tokencommando’s voor providers die tokenauthmethoden aanbieden.setup-tokenvereist een interactieve TTY en voert de tokenauthmethode van de provider uit (standaard desetup-token-methode van die provider wanneer die er een aanbiedt).paste-tokenaccepteert een tokenstring die elders of via automatisering is gegenereerd.paste-tokenvereist--provider, vraagt om de tokenwaarde en schrijft die naar de standaardprofiel-id<provider>:manual, tenzij je--profile-iddoorgeeft.paste-token --expires-in <duration>slaat een absolute tokenvervaldatum op uit een relatieve duur zoals365dof12h.- Anthropic-opmerking: Anthropic-medewerkers hebben ons verteld dat OpenClaw-stijl Claude CLI-gebruik weer is toegestaan, dus OpenClaw behandelt Claude CLI-hergebruik en
claude -p-gebruik als goedgekeurd voor deze integratie, tenzij Anthropic een nieuw beleid publiceert. - Anthropic
setup-token/paste-tokenblijven beschikbaar als een ondersteund OpenClaw-tokenpad, maar OpenClaw geeft nu de voorkeur aan Claude CLI-hergebruik enclaude -pwanneer beschikbaar.