Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw models

• Провайдери + моделі: Моделі
• Концепції вибору моделі + slash-команда /models: Концепція моделей
• Налаштування автентифікації провайдера: Початок роботи

​

Поширені команди

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

• models set <model-or-alias> приймає provider/model або аліас.
• models list доступна лише для читання: вона читає config, профілі автентифікації, наявний стан каталогу та рядки каталогу, що належать провайдеру, але не перезаписує models.json.
• Стовпець Auth є рівнем провайдера й доступний лише для читання. Він обчислюється з локальних метаданих профілів автентифікації, маркерів env, налаштованих ключів провайдера, маркерів локального провайдера, маркерів env/профілю AWS Bedrock і синтетичних метаданих автентифікації plugin; він не завантажує runtime провайдера, не читає секрети keychain, не викликає API провайдера і не доводить точну готовність виконання для кожної моделі.
• models list --all --provider <id> може містити статичні рядки каталогу, що належать провайдеру, з маніфестів plugin або вбудованих метаданих каталогу провайдера, навіть якщо ви ще не автентифікувалися з цим провайдером. Ці рядки все одно показуються як недоступні, доки не налаштовано відповідну автентифікацію.
• models list зберігає контрольну площину чутливою, доки виявлення каталогу провайдера повільне. Типове та налаштоване подання після короткого очікування повертаються до налаштованих або синтетичних рядків моделей і дають виявленню завершитися у фоновому режимі. Використовуйте --all, коли потрібен точний повний виявлений каталог і ви готові чекати на виявлення провайдера.
• Широке models list --all зливає рядки каталогу маніфесту поверх рядків registry без завантаження хуків доповнення runtime провайдера. Швидкі шляхи маніфесту з фільтром за провайдером використовують лише провайдерів, позначених static; провайдери, позначені refreshable, залишаються підтриманими registry/cache і додають рядки маніфесту як доповнення, тоді як провайдери, позначені runtime, залишаються на виявленні registry/runtime.
• models list тримає нативні метадані моделей і runtime-обмеження окремо. У табличному виводі Ctx показує contextTokens/contextWindow, коли ефективне runtime-обмеження відрізняється від нативного контекстного вікна; JSON-рядки містять contextTokens, коли провайдер надає це обмеження.
• models list --provider <id> фільтрує за id провайдера, наприклад moonshot або openai-codex. Вона не приймає відображувані назви з інтерактивних засобів вибору провайдера, наприклад Moonshot AI.
• Посилання на моделі розбираються поділом за першим /. Якщо ID моделі містить / (у стилі OpenRouter), додайте префікс провайдера (приклад: openrouter/moonshotai/kimi-k2).
• Якщо ви пропускаєте провайдера, OpenClaw спершу визначає вхідні дані як аліас, потім як унікальний збіг налаштованого провайдера для цього точного id моделі, і лише потім повертається до налаштованого типового провайдера з попередженням про застарілість. Якщо цей провайдер більше не надає налаштовану типову модель, OpenClaw повертається до першої налаштованої пари провайдер/модель замість показу застарілої типової моделі вилученого провайдера.
• models status може показувати marker(<value>) у виводі автентифікації для несекретних заповнювачів (наприклад OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) замість маскування їх як секретів.

​

Сканування моделей

• --no-probe (лише метадані; без пошуку config/секретів)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (запит каталогу та таймаут для кожної перевірки)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

Стан моделей

• --json
• --plain
• --check (exit 1=expired/missing, 2=expiring)
• --probe (жива перевірка налаштованих профілів автентифікації)
• --probe-provider <name> (перевірити одного провайдера)
• --probe-profile <id> (повторювані або розділені комами id профілів)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (id налаштованого агента; перевизначає OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

• excluded_by_auth_order: збережений профіль існує, але явний auth.order.<provider> пропустив його, тож перевірка повідомляє про виключення замість спроби використати його.
• missing_credential, invalid_expires, expired, unresolved_ref: профіль присутній, але не придатний/не може бути визначений.
• no_model: автентифікація провайдера існує, але OpenClaw не зміг визначити придатного для перевірки кандидата моделі для цього провайдера.

​

Аліаси + резервні варіанти

openclaw models aliases list
openclaw models fallbacks list

​

Профілі автентифікації

openclaw models auth add
openclaw models auth list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token

openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth list --provider openai

• setup-token і paste-token залишаються загальними командами токенів для провайдерів, які надають методи автентифікації токеном.
• setup-token потребує інтерактивного TTY і запускає метод автентифікації токеном провайдера (типово метод цього провайдера setup-token, коли він його надає).
• paste-token приймає рядок токена, згенерований деінде або з автоматизації.
• paste-token потребує --provider, запитує значення токена та записує його до типового id профілю <provider>:manual, якщо ви не передасте --profile-id.
• paste-token --expires-in <duration> зберігає абсолютний час завершення дії токена з відносної тривалості, наприклад 365d або 12h.
• Примітка Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI та використання claude -p санкціонованими для цієї інтеграції, доки Anthropic не опублікує нову політику.
• Anthropic setup-token / paste-token залишаються доступними як підтримуваний шлях токена OpenClaw, але OpenClaw тепер віддає перевагу повторному використанню Claude CLI та claude -p, коли вони доступні.

​

Пов’язано

• Довідник CLI
• Вибір моделі
• Резервне перемикання моделей