CLI commands
Dokumentacja referencyjna CLI
openclaw jest głównym punktem wejścia CLI. Każde podstawowe polecenie ma osobną stronę referencyjną albo jest udokumentowane razem z poleceniem, dla którego jest aliasem; ten indeks wymienia polecenia, flagi globalne oraz reguły stylizacji wyjścia obowiązujące w całym CLI.
Używaj poleceń konfiguracji zgodnie z intencją:
openclaw setuptworzy bazową konfigurację i obszar roboczy bez przechodzenia przez pełny prowadzony proces onboardingu.openclaw onboardto pełna prowadzona ścieżka pierwszego uruchomienia dla Gateway, uwierzytelniania modelu, obszaru roboczego, kanałów, Skills i kondycji.openclaw configurezmienia wybrane części istniejącej konfiguracji, takie jak uwierzytelnianie modelu, Gateway, kanały, plugins lub Skills.openclaw channels addkonfiguruje konta kanałów po utworzeniu konfiguracji bazowej; uruchom je bez flag, aby przejść przez prowadzoną konfigurację kanałów, albo z flagami właściwymi dla kanału w skryptach.
Strony poleceń
| Obszar | Polecenia |
|---|---|
| Konfiguracja i onboarding | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| Resetowanie i odinstalowanie | backup · reset · uninstall · update |
| Wiadomości i agenci | message · agent · agents · acp · mcp |
| Kondycja i sesje | status · health · sessions |
| Gateway i logi | gateway · logs · system |
| Modele i inferencja | models · infer · capability (alias dla infer) · memory · commitments · wiki |
| Sieć i węzły | directory · nodes · devices · node |
| Runtime i sandbox | approvals · exec-policy (zobacz approvals) · sandbox · tui · chat/terminal (aliasy dla tui --local) · browser |
| Automatyzacja | cron · tasks · hooks · webhooks |
| Odkrywanie i dokumentacja | dns · docs |
| Parowanie i kanały | pairing · qr · channels |
| Bezpieczeństwo i plugins | security · secrets · skills · plugins · proxy |
| Starsze aliasy | daemon (usługa Gateway) · clawbot (przestrzeń nazw) |
| Plugins (opcjonalne) | path · voicecall (jeśli zainstalowano) |
Flagi globalne
| Flaga | Cel |
|---|---|
--dev |
Izoluje stan w ~/.openclaw-dev i przesuwa domyślne porty |
--profile <name> |
Izoluje stan w ~/.openclaw-<name> |
--container <name> |
Wskazuje nazwany kontener jako cel wykonania |
--no-color |
Wyłącza kolory ANSI (respektowane jest też NO_COLOR=1) |
--update |
Skrót dla openclaw update (tylko instalacje ze źródła) |
-V, --version, -v |
Wypisuje wersję i kończy działanie |
Tryby wyjścia
- Kolory ANSI i wskaźniki postępu są renderowane tylko w sesjach TTY.
- Hiperłącza OSC-8 są renderowane jako klikalne linki tam, gdzie są obsługiwane; w przeciwnym razie CLI wraca do zwykłych adresów URL.
--json(oraz--plain, gdzie jest obsługiwane) wyłącza stylizację, aby uzyskać czyste wyjście.- Długo działające polecenia pokazują wskaźnik postępu (OSC 9;4, gdy jest obsługiwane).
Źródło prawdy dla palety: src/terminal/palette.ts.
Drzewo poleceń
Pełne drzewo poleceń
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifysecurity auditsecrets reload audit configure applyresetuninstallupdate wizard statuschannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update list info checkplugins list inspect install uninstall update enable disable doctor marketplace listmemory status index searchpath resolve find set validate emitcommitments list dismisswiki status doctor init ingest compile lint search get apply bridge import unsafe-local import 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-identityacpmcp serve list show set unsetstatushealthsessions cleanuptasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health 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 scaninfer (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|providers|status|enable|disable|set-provider video generate|describe|providers web search|fetch|providers embedding create|providers auth add|login|login-github-copilot|setup-token|paste-token auth order get|set|clearsandbox 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)Plugins mogą dodawać dodatkowe polecenia najwyższego poziomu (na przykład openclaw voicecall).
Polecenia ukośnikiem w czacie
Wiadomości czatu obsługują polecenia /.... Zobacz polecenia ukośnikiem.
Najważniejsze:
/status— szybka diagnostyka./trace— linie śledzenia/debugowania pluginu w zakresie sesji./config— utrwalone zmiany konfiguracji./debug— nadpisania konfiguracji tylko w runtime (pamięć, nie dysk; wymagacommands.debug: true).
Śledzenie użycia
openclaw status --usage oraz interfejs Control pokazują użycie/limit dostawcy, gdy dostępne są poświadczenia OAuth/API. Dane pochodzą bezpośrednio z punktów końcowych użycia dostawcy i są normalizowane do formatu X% left. Dostawcy z bieżącymi oknami użycia: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi i z.ai.
Szczegóły znajdziesz w Śledzeniu użycia.