CLI commands
Довідник CLI
openclaw — головна точка входу CLI. Кожна основна команда має окрему
довідкову сторінку або документується разом із командою, для якої вона є псевдонімом; цей покажчик містить
команди, глобальні прапорці та правила оформлення виводу, що застосовуються в усьому CLI.
Команди налаштування за призначенням:
openclaw setupіopenclaw onboardспочатку перевіряють інференс, а потім запускають Crestodian для налаштування Gateway, робочого простору, каналів, Skills і перевірки працездатності.openclaw setup --baselineстворює базову конфігурацію та робочий простір без проходження покрокового процесу початкового налаштування.openclaw configureзмінює окремі частини наявного налаштування: автентифікацію моделі, Gateway, канали, плагіни або Skills.openclaw channels addналаштовує облікові записи каналів після створення базової конфігурації; запустіть без прапорців для покрокового налаштування або з прапорцями конкретного каналу для сценаріїв.
Сторінки команд
| Область | Команди |
|---|---|
| Налаштування та початкова конфігурація | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| Скидання, резервне копіювання та міграція | backup · migrate · reset · uninstall · update |
| Обмін повідомленнями та агенти | message · agent · agents · attach · acp · mcp |
| Працездатність і сеанси | status · health · sessions · audit |
| Gateway і журнали | gateway · logs · system |
| Моделі та інференс | models · promos · infer · capability (псевдонім для infer) · memory · commitments · wiki |
| Мережа та вузли | directory · nodes · devices · node |
| Середовище виконання та пісочниця | approvals · exec-policy (див. approvals) · sandbox · tui · chat/terminal (псевдоніми для tui --local) · browser |
| Автоматизація | cron · tasks · hooks · webhooks · transcripts |
| Виявлення та документація | dns · docs |
| Сполучення та канали | pairing · qr · channels |
| Безпека та плагіни | security · secrets · skills · plugins · proxy |
| Застарілі псевдоніми | daemon (служба Gateway) · clawbot (простір імен) |
| Плагіни (необов’язкові) | path · policy · voicecall · workboard (якщо встановлено) |
Глобальні прапорці
| Прапорець | Призначення |
|---|---|
--dev |
Ізолює стан у ~/.openclaw-dev, установлює стандартний порт Gateway 19001 і зміщує похідні порти |
--profile <name> |
Ізолює стан у ~/.openclaw-<name> (OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH) |
--container <name> |
Запускає CLI всередині запущеного контейнера Podman/Docker із назвою <name> (типово: змінна середовища OPENCLAW_CONTAINER) |
--log-level <level> |
Перевизначає глобальний рівень журналювання для виводу у файл і консоль |
--no-color |
Вимикає кольори ANSI (також враховується NO_COLOR=1) |
--update |
Скорочення для openclaw update; працює як для робочих копій вихідного коду, так і для встановлень пакета |
-V, --version, -v |
Виводить версію та завершує роботу |
Режими виводу
- Кольори ANSI та індикатори поступу відображаються лише в сеансах TTY.
- Гіперпосилання OSC-8 відображаються як активні посилання там, де це підтримується; інакше CLI використовує звичайні URL-адреси.
--json(і--plain, де підтримується) вимикає оформлення для чистого виводу.- Тривалі команди показують індикатор поступу (OSC 9;4, якщо підтримується).
Палітра кольорів
OpenClaw використовує «омарову» палітру для виводу CLI:
| Токен | Hex | Використовується для |
|---|---|---|
accent |
#FF5A2D |
Заголовків, міток, основних виділень |
accentBright |
#FF7A3D |
Назв команд, акцентування |
accentDim |
#D14A22 |
Тексту другорядних виділень |
info |
#FF8A5B |
Інформаційних значень |
success |
#2FBF71 |
Станів успішного виконання |
warn |
#FFB020 |
Попереджень, прапорців параметрів, резервних варіантів |
error |
#E23D2D |
Помилок, збоїв |
muted |
#8B7F77 |
Зменшення акценту, метаданих |
Єдине джерело істини для палітри: packages/terminal-core/src/palette.ts.
Дерево команд
Повне дерево команд
Ця схема охоплює основні команди та їхні головні підкоманди. Додані плагінами
підкоманди (наприклад, у skills, plugins і wiki) розвиваються
незалежно; виконайте <command> --help, щоб отримати актуальний авторитетний список.
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifymigrate list plan <provider> apply <provider>security auditsecrets reload audit configure applyresetuninstallupdate wizard status repairchannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update verify workshop list|inspect|propose-create|propose-update|revise|apply|reject|quarantine list info checkplugins list search inspect install uninstall update enable disable doctor build validate init registry marketplace list|entries|refreshworkboard list create show dispatchmemory status index searchtranscripts list show pathpath resolve find set validate emitcommitments list dismisswiki status doctor init compile lint ingest okf import search get apply synthesis|metadata bridge import unsafe-local import chatgpt import|rollback obsidian status|search|open|command|dailymessage send broadcast poll react reactions read edit delete pin unpin pins permissions search thread create|list|reply emoji list|upload sticker send|upload role info|add|remove channel info|list member info voice status event list|create timeout kick banagentagents list add delete bindings bind unbind set-identityattachacpmcp serve list show set unsetstatushealthsessions cleanupaudittasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health stability diagnostics export status probe discover install uninstall start stop restart rundaemon status install uninstall start stop restartlogssystem event heartbeat last|enable|disable presencemodels list status set set-image aliases list|add|remove fallbacks list|add|remove|clear image-fallbacks list|add|remove|clear scan auth list|add|login|setup-token|paste-token|paste-api-key|login-github-copilot auth order get|set|clearpromos list claim <slug>infer (alias: capability) list inspect model run|list|inspect|providers|auth login|logout|status image generate|edit|describe|describe-many|providers audio transcribe|providers tts convert|voices|personas|providers|status|enable|disable|set-provider|set-persona video generate|describe|providers web search|fetch|providers embedding create|providerssandbox list recreate explaincron status list get add edit rm enable disable runs runnodes status describe list pending approve reject rename invoke notify push canvas snapshot|present|hide|navigate|eval canvas a2ui push|reset camera list|snap|clip screen record location getdevices list remove clear approve reject rotate revokenode run status install uninstall stop restartapprovals get set allowlist add|removeexec-policy show preset setbrowser status start stop reset-profile tabs open focus close profiles create-profile delete-profile screenshot snapshot navigate resize click type press hover drag select upload fill dialog wait evaluate console pdfhooks list info check enable disable install updatewebhooks gmail setup|runproxy start run coverage sessions query blob purgepairing list approveqrclawbot qrdocsdns setuptuichat (alias: tui --local)terminal (alias: tui --local)Плагіни можуть додавати додаткові команди верхнього рівня, як-от
openclaw workboard або openclaw voicecall.
Команди з похилою рискою в чаті
Повідомлення чату підтримують команди /.... Див. команди з похилою рискою.
Основні команди:
/status— швидка діагностика./trace— рядки трасування та налагодження плагінів у межах сеансу./config— збережені зміни конфігурації./debug— перевизначення конфігурації лише під час виконання (у пам’яті, а не на диску; потребуєcommands.debug: true).
Відстеження використання
openclaw status --usage та інтерфейс керування відображають використання й квоту постачальника, коли
доступні облікові дані OAuth/API. Дані надходять безпосередньо з кінцевих точок
використання постачальників і нормалізуються до формату X% left. Постачальники, для яких наразі доступні
вікна використання: Anthropic, Gemini CLI, GitHub Copilot, MiniMax, OpenAI Codex,
Xiaomi та z.ai.
Докладніше див. у розділі Відстеження використання.