Matrix Protocol: - docker-compose.matrix.yml: Dendrite homeserver + PostgreSQL + Nginx TLS - src/channels/plugins/matrix-channel.ts: OpenClaw plugin implementation - docs/matrix-triad-setup.md: Setup guide with auth scheme (@tm1-4:triad.local) MCP Server Integration: - docs/mcp-triad-integration.md: SearXNG, Playwright, GitHub MCP configs - docs/mcp-curiosity-mapping.md: Gap-to-capability mapping Node Sync Architecture: - src/services/node-sync-service.ts: WebSocket peer sync + presence detection - src/services/node-sync-service.test.ts: Unit tests - docs/node-sync-architecture.md: Architecture docs Triad Resilience: - scripts/triad-corruption-check.mjs: SQLite + log + config + git integrity - docs/triad-resilience.md: Recovery procedures - .secure/deployment-logs/README.md: Schema v2 - skills/triad-heartbeat/SKILL.md: Corruption check integration NPM Publish Workflow: - scripts/npm-publish.mjs: version, changelog, validate, publish, rollback - .github/workflows/npm-publish.yml: GitHub Actions with provenance - docs/npm-publish-guide.md: Complete documentation All deliverables tested in Docker before production.
3.0 KiB
Executable File
summary, read_when, title
| summary | read_when | title | ||
|---|---|---|---|---|
| CLI reference for `openclaw models` (status/list/set/scan, aliases, fallbacks, auth) |
|
models |
openclaw models
Model discovery, scanning, and configuration (default model, fallbacks, auth profiles).
Related:
- Providers + models: Models
- Provider auth setup: Getting started
Common commands
openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan
openclaw models status shows the resolved default/fallbacks plus an auth overview.
When provider usage snapshots are available, the OAuth/token status section includes
provider usage headers.
Add --probe to run live auth probes against each configured provider profile.
Probes are real requests (may consume tokens and trigger rate limits).
Use --agent <id> to inspect a configured agent’s model/auth state. When omitted,
the command uses OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR if set, otherwise the
configured default agent.
Notes:
models set <model-or-alias>acceptsprovider/modelor an alias.- 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 treats the input as an alias or a model for the default provider (only works when there is no
/in the model ID). models statusmay showmarker(<value>)in auth output for non-secret placeholders (for exampleOPENAI_API_KEY,secretref-managed,minimax-oauth,qwen-oauth,ollama-local) instead of masking them as secrets.
models status
Options:
--json--plain--check(exit 1=expired/missing, 2=expiring)--probe(live probe of configured auth profiles)--probe-provider <name>(probe one provider)--probe-profile <id>(repeat or comma-separated profile ids)--probe-timeout <ms>--probe-concurrency <n>--probe-max-tokens <n>--agent <id>(configured agent id; overridesOPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)
Aliases + fallbacks
openclaw models aliases list
openclaw models fallbacks list
Auth profiles
openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token
models auth login runs a provider plugin’s auth flow (OAuth/API key). Use
openclaw plugins list to see which providers are installed.
Notes:
setup-tokenprompts for a setup-token value (generate it withclaude setup-tokenon any machine).paste-tokenaccepts a token string generated elsewhere or from automation.- Anthropic policy note: setup-token support is technical compatibility. Anthropic has blocked some subscription usage outside Claude Code in the past, so verify current terms before using it broadly.