CLI commands
Справочник по CLI
openclaw — основная точка входа CLI. Для каждой основной команды предусмотрена отдельная
справочная страница либо документация вместе с командой, псевдонимом которой она является; в этом указателе перечислены
команды, глобальные флаги и правила оформления вывода, применяемые во всём CLI.
Команды настройки по назначению:
openclaw setupиopenclaw onboardсначала проверяют логический вывод, а затем запускают OpenClaw для настройки Gateway, рабочего пространства, каналов, навыков и проверки работоспособности.openclaw setup --baselineсоздаёт базовую конфигурацию и рабочее пространство без прохождения пошагового процесса первоначальной настройки.openclaw configureизменяет отдельные части существующей настройки: аутентификацию модели, Gateway, каналы, плагины или навыки.openclaw channels addнастраивает учётные записи каналов после создания базовой конфигурации; запустите без флагов для пошаговой настройки или с флагами конкретных каналов для сценариев.
Страницы команд
| Область | Команды |
|---|---|
| Настройка и начало работы | openclaw · 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 · worker |
| Среда выполнения и песочница | 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>openclawsetuponboardconfigureconfig 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 restartworkerapprovals 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.
Подробности см. в разделе Отслеживание использования.