CLI commands
CLI başvurusu
openclaw, ana CLI giriş noktasıdır. Her çekirdek komutun kendine ait bir
başvuru sayfası vardır veya diğer adı olduğu komutla birlikte belgelenir; bu dizin,
CLI genelinde geçerli olan komutları, genel bayrakları ve çıktı biçimlendirme kurallarını listeler.
Amaca göre kurulum komutları:
openclaw setupveopenclaw onboardönce çıkarımı doğrular, ardından Gateway, çalışma alanı, kanallar, Skills ve sistem durumu kurulumu için Crestodian'ı başlatır.openclaw setup --baseline, yönlendirmeli ilk katılım akışını izlemeden temel yapılandırmayı ve çalışma alanını oluşturur.openclaw configure, mevcut bir kurulumun hedeflenen bölümlerini değiştirir: model kimlik doğrulaması, Gateway, kanallar, Plugin'ler veya Skills.openclaw channels add, temel yapılandırma oluşturulduktan sonra kanal hesaplarını yapılandırır; yönlendirmeli kurulum için bayraksız, betikler içinse kanala özgü bayraklarla çalıştırın.
Komut sayfaları
| Alan | Komutlar |
|---|---|
| Kurulum ve ilk katılım | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| Sıfırlama, yedekleme ve geçiş | backup · migrate · reset · uninstall · update |
| Mesajlaşma ve aracılar | message · agent · agents · attach · acp · mcp |
| Sistem durumu ve oturumlar | status · health · sessions · audit |
| Gateway ve günlükler | gateway · logs · system |
| Modeller ve çıkarım | models · promos · infer · capability (infer için diğer ad) · memory · commitments · wiki |
| Ağ ve Node'lar | directory · nodes · devices · node |
| Çalışma zamanı ve korumalı alan | approvals · exec-policy (bkz. approvals) · sandbox · tui · chat/terminal (tui --local için diğer adlar) · browser |
| Otomasyon | cron · tasks · hooks · webhooks · transcripts |
| Keşif ve belgeler | dns · docs |
| Eşleştirme ve kanallar | pairing · qr · channels |
| Güvenlik ve Plugin'ler | security · secrets · skills · plugins · proxy |
| Eski diğer adlar | daemon (Gateway hizmeti) · clawbot (ad alanı) |
| Plugin'ler (isteğe bağlı) | path · policy · voicecall · workboard (kuruluysa) |
Genel bayraklar
| Bayrak | Amaç |
|---|---|
--dev |
Durumu ~/.openclaw-dev altında yalıtır, varsayılan Gateway bağlantı noktasını 19001 yapar ve türetilmiş bağlantı noktalarını kaydırır |
--profile <name> |
Durumu ~/.openclaw-<name> altında yalıtır (OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH) |
--container <name> |
CLI'yi <name> adlı çalışan bir Podman/Docker konteynerinin içinde çalıştırır (varsayılan: OPENCLAW_CONTAINER ortam değişkeni) |
--log-level <level> |
Dosya ve konsol çıktısı için genel günlük düzeyini geçersiz kılar |
--no-color |
ANSI renklerini devre dışı bırakır (NO_COLOR=1 ayarına da uyulur) |
--update |
openclaw update için kısaltmadır; hem kaynak kod çalışma kopyalarında hem de paket kurulumlarında çalışır |
-V, --version, -v |
Sürümü yazdırır ve çıkar |
Çıktı kipleri
- ANSI renkleri ve ilerleme göstergeleri yalnızca TTY oturumlarında görüntülenir.
- OSC-8 köprüleri, desteklenen ortamlarda tıklanabilir bağlantılar olarak görüntülenir; aksi durumda CLI düz URL'lere geri döner.
--json(ve desteklenen yerlerde--plain), temiz çıktı için biçimlendirmeyi devre dışı bırakır.- Uzun süre çalışan komutlar bir ilerleme göstergesi görüntüler (destekleniyorsa OSC 9;4).
Renk paleti
OpenClaw, CLI çıktısı için ıstakoz temalı bir palet kullanır:
| Belirteç | Hex | Kullanıldığı yerler |
|---|---|---|
accent |
#FF5A2D |
Başlıklar, etiketler, birincil vurgular |
accentBright |
#FF7A3D |
Komut adları, vurgu |
accentDim |
#D14A22 |
İkincil vurgu metni |
info |
#FF8A5B |
Bilgilendirici değerler |
success |
#2FBF71 |
Başarı durumları |
warn |
#FFB020 |
Uyarılar, seçenek bayrakları, geri dönüşler |
error |
#E23D2D |
Hatalar, başarısızlıklar |
muted |
#8B7F77 |
Vurguyu azaltma, meta veriler |
Paletin doğruluk kaynağı: packages/terminal-core/src/palette.ts.
Komut ağacı
Tam komut ağacı
Bu harita, çekirdek komutları ve bunların birincil alt komutlarını kapsar. Plugin tarafından eklenen
alt komutlar (örneğin skills, plugins ve wiki altındakiler) bağımsız olarak
gelişir; yetkili ve güncel liste için <command> --help komutunu çalıştırın.
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)Pluginler, openclaw workboard veya openclaw voicecall gibi ek üst düzey komutlar ekleyebilir.
Sohbet eğik çizgi komutları
Sohbet iletileri /... komutlarını destekler. Bkz. eğik çizgi komutları.
Öne çıkanlar:
/status- hızlı tanılama./trace- oturum kapsamındaki Plugin izleme/hata ayıklama satırları./config- kalıcı yapılandırma değişiklikleri./debug- yalnızca çalışma zamanına yönelik yapılandırma geçersiz kılmaları (diskte değil, bellekte tutulur;commands.debug: truegerektirir).
Kullanım takibi
OAuth/API kimlik bilgileri kullanılabilir olduğunda openclaw status --usage ve Denetim Arayüzü, sağlayıcı kullanımını/kotasını gösterir. Veriler doğrudan sağlayıcı kullanım uç noktalarından gelir ve X% left biçimine normalleştirilir. Güncel kullanım pencerelerine sahip sağlayıcılar: Anthropic, Gemini CLI, GitHub Copilot, MiniMax, OpenAI Codex, Xiaomi ve z.ai.
Ayrıntılar için Kullanım takibi bölümüne bakın.