​

CLI başvurusu

​

Komut sayfaları

• setup
• onboard
• configure
• config
• completion
• doctor
• dashboard
• backup
• reset
• uninstall
• update
• message
• agent
• agents
• acp
• mcp
• status
• health
• sessions
• gateway
• logs
• system
• models
• memory
• directory
• nodes
• devices
• node
• approvals
• sandbox
• tui
• browser
• cron
• tasks
• flows
• dns
• docs
• hooks
• webhooks
• pairing
• qr
• plugins (eklenti komutları)
• channels
• security
• secrets
• skills
• daemon (gateway hizmet komutları için eski takma ad)
• clawbot (eski takma ad ad alanı)
• voicecall (eklenti; kuruluysa)

​

Global bayraklar

• --dev: durumu ~/.openclaw-dev altında yalıtır ve varsayılan bağlantı noktalarını kaydırır.
• --profile <name>: durumu ~/.openclaw-<name> altında yalıtır.
• --container <name>: yürütme için adlı bir kapsayıcıyı hedefler.
• --no-color: ANSI renklerini devre dışı bırakır.
• --update: openclaw update için kısa yol (yalnızca kaynak kurulumları).
• -V, --version, -v: sürümü yazdırır ve çıkar.

​

Çıktı biçimlendirmesi

• ANSI renkleri ve ilerleme göstergeleri yalnızca TTY oturumlarında görüntülenir.
• OSC-8 köprüleri desteklenen terminallerde tıklanabilir bağlantılar olarak görüntülenir; aksi halde düz URL’lere geri düşeriz.
• --json (ve desteklenen yerlerde --plain) temiz çıktı için biçimlendirmeyi devre dışı bırakır.
• --no-color ANSI biçimlendirmesini devre dışı bırakır; NO_COLOR=1 de dikkate alınır.
• Uzun süren komutlar bir ilerleme göstergesi gösterir (destekleniyorsa OSC 9;4).

​

Renk paleti

• accent (#FF5A2D): başlıklar, etiketler, birincil vurgular.
• accentBright (#FF7A3D): komut adları, vurgu.
• accentDim (#D14A22): ikincil vurgu metni.
• info (#FF8A5B): bilgilendirici değerler.
• success (#2FBF71): başarı durumları.
• warn (#FFB020): uyarılar, geri dönüşler, dikkat gerektiren durumlar.
• error (#E23D2D): hatalar, başarısızlıklar.
• muted (#8B7F77): geri planda bırakma, meta veriler.

​

Komut ağacı

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
    file
    schema
    validate
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    audit
    configure
    apply
  reset
  uninstall
  update
    wizard
    status
  channels
    list
    status
    capabilities
    resolve
    logs
    add
    remove
    login
    logout
  directory
    self
    peers list
    groups list|members
  skills
    search
    install
    update
    list
    info
    check
  plugins
    list
    inspect
    install
    uninstall
    update
    enable
    disable
    doctor
    marketplace list
  memory
    status
    index
    search
  message
    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
    ban
  agent
  agents
    list
    add
    delete
    bindings
    bind
    unbind
    set-identity
  acp
  mcp
    serve
    list
    show
    set
    unset
  status
  health
  sessions
    cleanup
  tasks
    list
    audit
    maintenance
    show
    notify
    cancel
    flow list|show|cancel
  gateway
    call
    usage-cost
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  daemon
    status
    install
    uninstall
    start
    stop
    restart
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
    auth add|login|login-github-copilot|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
    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 get
  devices
    list
    remove
    clear
    approve
    reject
    rotate
    revoke
  node
    run
    status
    install
    uninstall
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    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
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  qr
  clawbot
    qr
  docs
  dns
    setup
  tui

​

Güvenlik

• openclaw security audit — yaygın güvenlik tuzakları için config + yerel durumu denetler.
• openclaw security audit --deep — en iyi çabayla canlı Gateway yoklaması.
• openclaw security audit --fix — güvenli varsayılanları ve durum/config izinlerini sıkılaştırır.

​

Gizli bilgiler

​

secrets

• secrets reload
• secrets audit
• secrets configure
• secrets apply --from <path>

• --url, --token, --timeout, --expect-final, --json

• --check
• --allow-exec
• --json

• --apply
• --yes
• --providers-only
• --skip-provider-setup
• --agent <id>
• --allow-exec
• --plan-out <path>
• --json

• --dry-run
• --allow-exec
• --json

• reload bir Gateway RPC’sidir ve çözümleme başarısız olduğunda bilinen son iyi çalışma zamanı anlık görüntüsünü korur.
• audit --check bulgu varsa sıfır dışı döner; çözümlenmemiş referanslar daha yüksek öncelikli bir sıfır dışı çıkış kodu kullanır.
• Dry-run exec denetimleri varsayılan olarak atlanır; dahil etmek için --allow-exec kullanın.

​

Eklentiler

• openclaw plugins list — eklentileri keşfeder (makine çıktısı için --json kullanın).
• openclaw plugins inspect <id> — bir eklentinin ayrıntılarını gösterir (info bir takma addır).
• openclaw plugins install <path|.tgz|npm-spec|plugin@marketplace> — bir eklenti kurar (veya plugins.load.paths içine bir eklenti yolu ekler; mevcut bir kurulum hedefinin üzerine yazmak için --force kullanın).
• openclaw plugins marketplace list <marketplace> — kurulumdan önce pazar yeri girdilerini listeler.
• openclaw plugins enable <id> / disable <id> — plugins.entries.<id>.enabled değerini açar/kapatır.
• openclaw plugins doctor — eklenti yükleme hatalarını bildirir.

​

Bellek

• openclaw memory status — dizin istatistiklerini gösterir; vektör + gömme hazırlık denetimleri için --deep, eski recall/promotion yapıtlarını onarmak için --fix kullanın.
• openclaw memory index — bellek dosyalarını yeniden dizinler.
• openclaw memory search "<query>" (veya --query "<query>") — bellek üzerinde anlamsal arama.
• openclaw memory promote — kısa vadeli geri çağırmaları sıralar ve isteğe bağlı olarak en üstteki girdileri MEMORY.md içine ekler.

​

Sandbox

• sandbox list [--browser] [--json]
• sandbox recreate [--all] [--session <key>] [--agent <id>] [--browser] [--force]
• sandbox explain [--session <key>] [--agent <id>] [--json]

• sandbox recreate mevcut çalışma zamanlarını kaldırır; böylece sonraki kullanım bunları mevcut config ile yeniden başlatır.
• ssh ve OpenShell remote arka uçları için recreate, seçilen kapsamın kanonik uzak çalışma alanını siler.

​

Sohbet slash komutları

• Hızlı tanı için /status.
• Kalıcı config değişiklikleri için /config.
• Yalnızca çalışma zamanı config geçersiz kılmaları için /debug (bellek, disk değil; commands.debug: true gerektirir).

​

Kurulum + onboarding

​

completion

• -s, --shell <zsh|bash|powershell|fish>
• -i, --install
• --write-state
• -y, --yes

• --install veya --write-state olmadan completion betiği stdout’a yazdırır.
• --install, kabuk profilinize bir OpenClaw Completion bloğu yazar ve bunu OpenClaw durum dizini altındaki önbelleğe alınmış betiğe yönlendirir.

​

setup

• --workspace <dir>: agent çalışma alanı yolu (varsayılan ~/.openclaw/workspace).
• --wizard: onboarding’i çalıştırır.
• --non-interactive: onboarding’i istemler olmadan çalıştırır.
• --mode <local|remote>: onboard modu.
• --remote-url <url>: uzak Gateway URL’si.
• --remote-token <token>: uzak Gateway belirteci.

​

onboard

• --workspace <dir>
• --reset (onboarding’den önce config + kimlik bilgileri + oturumları sıfırla)
• --reset-scope <config|config+creds+sessions|full> (varsayılan config+creds+sessions; çalışma alanını da kaldırmak için full kullanın)
• --non-interactive
• --mode <local|remote>
• --flow <quickstart|advanced|manual> (manual, advanced için bir takma addır)
• --auth-choice <choice> burada <choice> şunlardan biridir: chutes, deepseek-api-key, openai-codex, openai-api-key, openrouter-api-key, kilocode-api-key, litellm-api-key, ai-gateway-api-key, cloudflare-ai-gateway-api-key, moonshot-api-key, moonshot-api-key-cn, kimi-code-api-key, synthetic-api-key, venice-api-key, together-api-key, huggingface-api-key, apiKey, gemini-api-key, google-gemini-cli, zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn, xiaomi-api-key, minimax-global-oauth, minimax-global-api, minimax-cn-oauth, minimax-cn-api, opencode-zen, opencode-go, github-copilot, copilot-proxy, xai-api-key, mistral-api-key, volcengine-api-key, byteplus-api-key, qianfan-api-key, qwen-standard-api-key-cn, qwen-standard-api-key, qwen-api-key-cn, qwen-api-key, modelstudio-standard-api-key-cn, modelstudio-standard-api-key, modelstudio-api-key-cn, modelstudio-api-key, custom-api-key, skip
• Qwen notu: qwen-* kanonik auth-choice ailesidir. modelstudio-* kimlikleri yalnızca geriye dönük uyumluluk takma adları olarak kabul edilmeye devam eder.
• --secret-input-mode <plaintext|ref> (varsayılan plaintext; sağlayıcı varsayılan env referanslarını düz metin anahtarlar yerine saklamak için ref kullanın)
• --anthropic-api-key <key>
• --openai-api-key <key>
• --mistral-api-key <key>
• --openrouter-api-key <key>
• --ai-gateway-api-key <key>
• --moonshot-api-key <key>
• --kimi-code-api-key <key>
• --gemini-api-key <key>
• --zai-api-key <key>
• --minimax-api-key <key>
• --opencode-zen-api-key <key>
• --opencode-go-api-key <key>
• --custom-base-url <url> (etkileşimsiz; --auth-choice custom-api-key ile kullanılır)
• --custom-model-id <id> (etkileşimsiz; --auth-choice custom-api-key ile kullanılır)
• --custom-api-key <key> (etkileşimsiz; isteğe bağlı; --auth-choice custom-api-key ile kullanılır; belirtilmezse CUSTOM_API_KEY kullanılır)
• --custom-provider-id <id> (etkileşimsiz; isteğe bağlı özel sağlayıcı kimliği)
• --custom-compatibility <openai|anthropic> (etkileşimsiz; isteğe bağlı; varsayılan openai)
• --gateway-port <port>
• --gateway-bind <loopback|lan|tailnet|auto|custom>
• --gateway-auth <token|password>
• --gateway-token <token>
• --gateway-token-ref-env <name> (etkileşimsiz; gateway.auth.token değerini bir env SecretRef olarak saklar; bu env değişkeninin ayarlanmış olmasını gerektirir; --gateway-token ile birlikte kullanılamaz)
• --gateway-password <password>
• --remote-url <url>
• --remote-token <token>
• --tailscale <off|serve|funnel>
• --tailscale-reset-on-exit
• --install-daemon
• --no-install-daemon (takma ad: --skip-daemon)
• --daemon-runtime <node|bun>
• --skip-channels
• --skip-skills
• --skip-search
• --skip-health
• --skip-ui
• --cloudflare-ai-gateway-account-id <id>
• --cloudflare-ai-gateway-gateway-id <id>
• --node-manager <npm|pnpm|bun> (Skills için setup/onboarding düğüm yöneticisi; pnpm önerilir, bun da desteklenir)
• --json

​

configure

• --section <section> (tekrarlanabilir; sihirbazı belirli bölümlerle sınırlar)

​

config

• config get <path>: bir config değerini yazdırır (nokta/köşeli parantez yolu).
• config set: dört atama modunu destekler:
  • değer modu: config set <path> <value> (JSON5-veya-dize ayrıştırma)
  • SecretRef oluşturucu modu: config set <path> --ref-provider <provider> --ref-source <source> --ref-id <id>
  • sağlayıcı oluşturucu modu: config set secrets.providers.<alias> --provider-source <env|file|exec> ...
  • toplu mod: config set --batch-json '<json>' veya config set --batch-file <path>
• config set --dry-run: openclaw.json yazmadan atamaları doğrular (exec SecretRef denetimleri varsayılan olarak atlanır).
• config set --allow-exec --dry-run: exec SecretRef dry-run denetimlerini dahil eder (sağlayıcı komutlarını çalıştırabilir).
• config set --dry-run --json: makine tarafından okunabilir dry-run çıktısı verir (denetimler + tamlık sinyali, işlemler, denetlenen/atlanmış referanslar, hatalar).
• config set --strict-json: yol/değer girdisi için JSON5 ayrıştırmasını zorunlu kılar. --json, dry-run çıktı modu dışında katı ayrıştırma için eski bir takma ad olarak kalır.
• config unset <path>: bir değeri kaldırır.
• config file: etkin config dosyası yolunu yazdırır.
• config schema: openclaw.json için oluşturulan JSON şemasını yazdırır; iç içe nesne, joker karakter, dizi öğesi ve bileşim dalları boyunca aktarılan title / description belge meta verilerini ve en iyi çabayla canlı eklenti/kanal şema meta verilerini içerir.
• config validate: gateway’i başlatmadan mevcut config’i şemaya göre doğrular.
• config validate --json: makine tarafından okunabilir JSON çıktısı verir.

​

doctor

• --no-workspace-suggestions: çalışma alanı bellek ipuçlarını devre dışı bırakır.
• --yes: varsayılanları sormadan kabul eder (headless).
• --non-interactive: istemleri atlar; yalnızca güvenli geçişleri uygular.
• --deep: ek gateway kurulumları için sistem hizmetlerini tarar.
• --repair (takma ad: --fix): algılanan sorunlar için otomatik onarımlar dener.
• --force: kesinlikle gerekli olmasa bile onarımları zorlar.
• --generate-gateway-token: yeni bir gateway auth belirteci oluşturur.

​

dashboard

• --no-open: URL’yi yazdırır ancak tarayıcı başlatmaz

• SecretRef ile yönetilen gateway belirteçleri için dashboard, gizli bilgiyi terminal çıktısında veya tarayıcı başlatma argümanlarında açığa çıkarmak yerine belirteç içermeyen bir URL yazdırır veya açar.

​

update

• --json
• --no-restart
• --dry-run
• --channel <stable|beta|dev>
• --tag <dist-tag|version|spec>
• --timeout <seconds>
• --yes

• update status
• update wizard

• --json
• --timeout <seconds>

• --timeout <seconds>

• openclaw --update, openclaw update olarak yeniden yazılır.

​

backup

• backup create
• backup verify <archive>

• --output <path>
• --json
• --dry-run
• --verify
• --only-config
• --no-include-workspace

• --json

​

Kanal yardımcıları

​

channels

• channels list: yapılandırılmış kanalları ve auth profillerini gösterir.
• channels status: gateway erişilebilirliğini ve kanal sağlığını denetler (--probe, gateway erişilebilirse hesap başına canlı yoklama/denetim kontrollerini çalıştırır; değilse yalnızca config tabanlı kanal özetlerine geri döner. Daha geniş gateway sağlık yoklamaları için openclaw health veya openclaw status --deep kullanın).
• İpucu: channels status, yaygın yanlış yapılandırmaları algılayabildiğinde önerilen düzeltmelerle birlikte uyarılar yazdırır (ardından sizi openclaw doctor komutuna yönlendirir).
• channels logs: gateway günlük dosyasından son kanal günlüklerini gösterir.
• channels add: hiçbir bayrak verilmezse sihirbaz tarzı kurulum; bayraklar etkileşimsiz moda geçirir.
  • Hâlâ tek hesaplı üst düzey config kullanan bir kanala varsayılan olmayan bir hesap eklenirken, OpenClaw yeni hesabı yazmadan önce hesap kapsamlı değerleri kanal hesap eşlemesine yükseltir. Çoğu kanal accounts.default kullanır; Matrix bunun yerine mevcut eşleşen adlı/varsayılan hedefi koruyabilir.
  • Etkileşimsiz channels add, bağları otomatik oluşturmaz/yükseltmez; yalnızca kanal bağları varsayılan hesapla eşleşmeye devam eder.
• channels remove: varsayılan olarak devre dışı bırakır; istem olmadan config girdilerini kaldırmak için --delete geçin.
• channels login: etkileşimli kanal girişi (yalnızca WhatsApp Web).
• channels logout: bir kanal oturumundan çıkış yapar (destekleniyorsa).

• --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
• --account <id>: kanal hesap kimliği (varsayılan default)
• --name <label>: hesabın görünen adı

• --channel <channel> (varsayılan whatsapp; whatsapp/web destekler)
• --account <id>
• --verbose

• --channel <channel> (varsayılan whatsapp)
• --account <id>

• --no-usage: model sağlayıcı kullanım/kota anlık görüntülerini atlar (yalnızca OAuth/API tabanlı).
• --json: JSON çıktısı verir (--no-usage ayarlı değilse kullanım bilgilerini içerir).

• --probe
• --timeout <ms>
• --json

• --channel <name>
• --account <id> (yalnızca --channel ile)
• --target <dest>
• --timeout <ms>
• --json

• <entries...>
• --channel <name>
• --account <id>
• --kind <auto|user|group>
• --json

• --channel <name|all> (varsayılan all)
• --lines <n> (varsayılan 200)
• --json

• channels login, --verbose desteğine sahiptir.
• channels capabilities --account yalnızca --channel ayarlıysa geçerlidir.
• channels status --probe, kanal desteğine bağlı olarak taşıma durumu ile birlikte works, probe failed, audit ok veya audit failed gibi yoklama/denetim sonuçlarını gösterebilir.

openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
openclaw channels remove --channel discord --account work --delete
openclaw channels status --probe
openclaw status --deep

​

directory

• --channel <name>
• --account <id>
• --json

• directory self
• directory peers list [--query <text>] [--limit <n>]
• directory groups list [--query <text>] [--limit <n>]
• directory groups members --group-id <id> [--limit <n>]

​

skills

• skills search [query...]: ClawHub Skills içinde arama yapar.
• skills search --limit <n> --json: arama sonuçlarını sınırlar veya makine tarafından okunabilir çıktı verir.
• skills install <slug>: ClawHub’dan etkin çalışma alanına bir skill kurar.
• skills install <slug> --version <version>: belirli bir ClawHub sürümünü kurar.
• skills install <slug> --force: mevcut bir çalışma alanı skill klasörünün üzerine yazar.
• skills update <slug|--all>: izlenen ClawHub Skills’i günceller.
• skills list: Skills’i listeler (alt komut verilmezse varsayılan).
• skills list --json: stdout’a makine tarafından okunabilir skill envanteri verir.
• skills list --verbose: tabloda eksik gereksinimleri içerir.
• skills info <name>: tek bir skill için ayrıntıları gösterir.
• skills info <name> --json: stdout’a makine tarafından okunabilir ayrıntıları verir.
• skills check: hazır ve eksik gereksinimlerin özeti.
• skills check --json: stdout’a makine tarafından okunabilir hazırlık çıktısı verir.

• --eligible: yalnızca hazır Skills’i gösterir.
• --json: JSON çıktısı verir (biçimlendirme yok).
• -v, --verbose: eksik gereksinim ayrıntılarını içerir.

​

pairing

• pairing list [channel] [--channel <channel>] [--account <id>] [--json]
• pairing approve <channel> <code> [--account <id>] [--notify]
• pairing approve --channel <channel> [--account <id>] <code> [--notify]

• Tam olarak bir eşleştirme destekli kanal yapılandırılmışsa pairing approve <code> kullanımına da izin verilir.
• list ve approve, çok hesaplı kanallar için --account <id> desteğine sahiptir.

​

devices

• devices list [--json]
• devices approve [requestId] [--latest]
• devices reject <requestId>
• devices remove <deviceId>
• devices clear --yes [--pending]
• devices rotate --device <id> --role <role> [--scope <scope...>]
• devices revoke --device <id> --role <role>

• devices list ve devices approve, doğrudan eşleştirme kapsamı kullanılamadığında local loopback üzerinde yerel eşleştirme dosyalarına geri dönebilir.
• devices approve, requestId geçirilmediğinde veya --latest ayarlandığında en yeni bekleyen isteği otomatik seçer.
• Saklanan belirteçle yeniden bağlantılar, belirtecin önbelleğe alınmış onaylı kapsamlarını yeniden kullanır. Açık devices rotate --scope ..., gelecekteki önbellekli belirteç yeniden bağlantıları için saklanan kapsam kümesini günceller.
• devices rotate ve devices revoke JSON yükleri döndürür.

​

qr

• --remote
• --url <url>
• --public-url <url>
• --token <token>
• --password <password>
• --setup-code-only
• --no-ascii
• --json

• --token ve --password birlikte kullanılamaz.
• Kurulum kodu, paylaşılan gateway belirteci/parolası değil, kısa ömürlü bir bootstrap belirteci taşır.
• Yerleşik bootstrap aktarımı, birincil düğüm belirtecini scopes: [] olarak tutar.
• Aktarılan herhangi bir operatör bootstrap belirteci, operator.approvals, operator.read, operator.talk.secrets ve operator.write ile sınırlı kalır.
• Bootstrap kapsam denetimleri rol öneklidir; bu nedenle operatör izin listesi yalnızca operatör isteklerini karşılar; operatör olmayan roller yine kendi rol önekleri altındaki kapsamlara ihtiyaç duyar.
• --remote, gateway.remote.url veya etkin Tailscale Serve/Funnel URL’sini kullanabilir.
• Taradıktan sonra isteği openclaw devices list / openclaw devices approve <requestId> ile onaylayın.

​

clawbot

​

hooks

• hooks list
• hooks info <name>
• hooks check
• hooks enable <name>
• hooks disable <name>
• hooks install <path-or-spec> (openclaw plugins install için kullanımdan kalkmış takma ad)
• hooks update [id] (openclaw plugins update için kullanımdan kalkmış takma ad)

• --json
• --eligible
• -v, --verbose

• Eklenti tarafından yönetilen hook’lar openclaw hooks üzerinden etkinleştirilemez veya devre dışı bırakılamaz; bunun yerine sahip eklentiyi etkinleştirin veya devre dışı bırakın.
• hooks install ve hooks update uyumluluk takma adları olarak hâlâ çalışır, ancak kullanımdan kaldırma uyarıları yazdırır ve eklenti komutlarına yönlendirir.

​

webhooks

• webhooks gmail setup
• webhooks gmail run

​

webhooks gmail

• webhooks gmail setup (--account <email> gerektirir; --project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --json destekler)
• webhooks gmail run (aynı bayraklar için çalışma zamanı geçersiz kılmaları)

• setup, Gmail watch’ı ve OpenClaw’a bakan push yolunu yapılandırır.
• run, isteğe bağlı çalışma zamanı geçersiz kılmalarıyla yerel Gmail watcher/yenileme döngüsünü başlatır.

​

dns

• dns setup [--domain <domain>] [--apply]

​

dns setup

• --domain <domain>
• --apply: CoreDNS config’ini kurar/günceller (sudo gerektirir; yalnızca macOS).

• --apply olmadan bu, önerilen OpenClaw + Tailscale DNS config’ini yazdıran bir planlama yardımcısıdır.
• --apply şu anda yalnızca Homebrew CoreDNS kullanan macOS’u destekler.

​

Mesajlaşma + agent

​

message

• message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
• message thread <create|list|reply>
• message emoji <list|upload>
• message sticker <send|upload>
• message role <info|add|remove>
• message channel <info|list>
• message member info
• message voice status
• message event <list|create>

• openclaw message send --target +15555550123 --message "Hi"
• openclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

​

agent

• -m, --message <text>

• -t, --to <dest> (oturum anahtarı ve isteğe bağlı teslimat için)
• --session-id <id>
• --agent <id> (agent kimliği; yönlendirme bağlarını geçersiz kılar)
• --thinking <off|minimal|low|medium|high|xhigh> (sağlayıcı desteği değişir; CLI düzeyinde model kapılı değildir)
• --verbose <on|off>
• --channel <channel> (teslimat kanalı; ana oturum kanalını kullanmak için boş bırakın)
• --reply-to <target> (oturum yönlendirmesinden ayrı teslimat hedefi geçersiz kılma)
• --reply-channel <channel> (teslimat kanalı geçersiz kılma)
• --reply-account <id> (teslimat hesap kimliği geçersiz kılma)
• --local (gömülü çalıştırma; eklenti kayıt defteri yine önce önceden yüklenir)
• --deliver
• --json
• --timeout <seconds>

• Gateway modu, Gateway isteği başarısız olduğunda gömülü agent’a geri düşer.
• --local yine de eklenti kayıt defterini önceden yükler; böylece eklenti tarafından sağlanan sağlayıcılar, araçlar ve kanallar gömülü çalıştırmalar sırasında da kullanılabilir.
• --channel, --reply-channel ve --reply-account, yönlendirmeyi değil yanıt teslimatını etkiler.

​

agents

​

agents list

• --json
• --bindings

​

agents add [name]

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (tekrarlanabilir)
• --non-interactive
• --json

​

agents bindings

• --agent <id>
• --json

​

agents bind

• --agent <id> (varsayılan olarak mevcut varsayılan agent)
• --bind <channel[:accountId]> (tekrarlanabilir)
• --json

​

agents unbind

• --agent <id> (varsayılan olarak mevcut varsayılan agent)
• --bind <channel[:accountId]> (tekrarlanabilir)
• --all
• --json

​

agents delete <id>

• --force
• --json

• main silinemez.
• --force olmadan etkileşimli onay gerekir.

​

agents set-identity

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

• Hedef agent’ı seçmek için --agent veya --workspace kullanılabilir.
• Açık kimlik alanları verilmediğinde komut IDENTITY.md dosyasını okur.

​

acp

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --session <key>
• --session-label <label>
• --require-existing
• --reset-session
• --no-prefix-cwd
• --provenance <off|meta|meta+receipt>
• --verbose

​

acp client

• --cwd <dir>
• --server <command>
• --server-args <args...>
• --server-verbose
• --verbose

​

mcp

​

mcp serve

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --claude-channel-mode <auto|on|off>
• --verbose

​

mcp list

• --json

​

mcp show [name]

• --json

​

mcp set <name> <value>

​

mcp unset <name>

​

approvals

​

approvals get

• --node <node>
• --gateway
• --json
• openclaw nodes içinden düğüm RPC seçenekleri

​

approvals set

• --node <node>
• --gateway
• --file <path>
• --stdin
• --json
• openclaw nodes içinden düğüm RPC seçenekleri

​

approvals allowlist add|remove

• --node <node>
• --gateway
• --agent <id> (varsayılan *)
• --json
• openclaw nodes içinden düğüm RPC seçenekleri

​

status

• --json
• --all (tam tanı; salt okunur, yapıştırılabilir)
• --deep (gateway’den, destekleniyorsa kanal yoklamaları da içeren canlı sağlık yoklaması ister)
• --usage (model sağlayıcı kullanım/kotasını gösterir)
• --timeout <ms>
• --verbose
• --debug (--verbose için takma ad)

• Genel görünüm, mevcut olduğunda Gateway + düğüm ana makine hizmeti durumunu içerir.
• --usage, normalize edilmiş sağlayıcı kullanım pencerelerini X% left olarak yazdırır.

​

Kullanım takibi

• /status (mevcut olduğunda kısa bir sağlayıcı kullanım satırı ekler)
• openclaw status --usage (tam sağlayıcı dökümünü yazdırır)
• macOS menü çubuğu (Bağlam altındaki Kullanım bölümü)

• Veriler doğrudan sağlayıcı kullanım uç noktalarından gelir (tahmin yoktur).
• İnsan tarafından okunabilir çıktı, sağlayıcılar arasında X% left olarak normalize edilir.
• Güncel kullanım pencerelerine sahip sağlayıcılar: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi ve z.ai.
• MiniMax notu: ham usage_percent / usagePercent, kalan kota anlamına gelir; bu yüzden OpenClaw bunu gösterimden önce ters çevirir; mevcutsa sayım tabanlı alanlar yine önceliklidir. model_remains yanıtları sohbet modeli girdisini tercih eder, gerekirse pencere etiketini zaman damgalarından türetir ve model adını plan etiketine ekler.
• Kullanım auth bilgisi, mevcut olduğunda sağlayıcıya özgü hook’lardan gelir; aksi halde OpenClaw, auth profilleri, env veya config içinden eşleşen OAuth/API-key kimlik bilgilerine geri düşer. Hiçbiri çözümlenmezse kullanım gizlenir.
• Ayrıntılar: bkz. Usage tracking.

​

health

• --json
• --timeout <ms>
• --verbose (canlı yoklamayı zorlar ve gateway bağlantı ayrıntılarını yazdırır)
• --debug (--verbose için takma ad)

• Varsayılan health, yeni bir önbelleğe alınmış gateway anlık görüntüsü döndürebilir.
• health --verbose, canlı yoklamayı zorlar ve insan tarafından okunabilir çıktıyı tüm yapılandırılmış hesaplar ve agent’lar genelinde genişletir.

​

sessions

• --json
• --verbose
• --store <path>
• --active <minutes>
• --agent <id> (oturumları agent’a göre filtreler)
• --all-agents (tüm agent’lardaki oturumları gösterir)

• sessions cleanup — süresi dolmuş veya yetim kalmış oturumları kaldırır

• sessions cleanup, transkript dosyaları kayıp olan girdileri temizlemek için --fix-missing desteğine de sahiptir.

​

Sıfırlama / Kaldırma

​

reset

• --scope <config|config+creds+sessions|full>
• --yes
• --non-interactive
• --dry-run

• --non-interactive, --scope ve --yes gerektirir.

​

uninstall

• --service
• --state
• --workspace
• --app
• --all
• --yes
• --non-interactive
• --dry-run

• --non-interactive, --yes ve açık kapsamlar (veya --all) gerektirir.
• --all, hizmeti, durumu, çalışma alanını ve uygulamayı birlikte kaldırır.

​

tasks

• tasks list — etkin ve son görev çalıştırmalarını gösterir
• tasks show <id> — belirli bir görev çalıştırmasının ayrıntılarını gösterir
• tasks notify <id> — bir görev çalıştırmasının bildirim ilkesini değiştirir
• tasks cancel <id> — çalışan bir görevi iptal eder
• tasks audit — operasyonel sorunları ortaya çıkarır (eski, kayıp, teslimat hataları)
• tasks maintenance [--apply] [--json] — görev ve TaskFlow temizleme/uzlaştırmayı önizler veya uygular (ACP/alt agent alt oturumları, etkin cron işleri, canlı CLI çalıştırmaları)
• tasks flow list — etkin ve son Task Flow akışlarını listeler
• tasks flow show <lookup> — bir akışı kimliğe veya arama anahtarına göre inceler
• tasks flow cancel <lookup> — çalışan bir akışı ve onun etkin görevlerini iptal eder

​

flows

• tasks flow list [--json]
• tasks flow show <lookup>
• tasks flow cancel <lookup>

​

Gateway

​

gateway

• --port <port>
• --bind <loopback|tailnet|lan|auto|custom>
• --token <token>
• --auth <token|password>
• --password <password>
• --password-file <path>
• --tailscale <off|serve|funnel>
• --tailscale-reset-on-exit
• --allow-unconfigured
• --dev
• --reset (geliştirme config + kimlik bilgileri + oturumlar + çalışma alanını sıfırlar)
• --force (bağlantı noktasındaki mevcut dinleyiciyi öldürür)
• --verbose
• --cli-backend-logs
• --claude-cli-logs (kullanımdan kalkmış takma ad)
• --ws-log <auto|full|compact>
• --compact (--ws-log compact için takma ad)
• --raw-stream
• --raw-stream-path <path>

​

gateway service

• gateway status (varsayılan olarak Gateway RPC’yi yoklar)
• gateway install (hizmet kurulumu)
• gateway uninstall
• gateway start
• gateway stop
• gateway restart

• gateway status, varsayılan olarak hizmetin çözümlenmiş bağlantı noktası/config’i kullanarak Gateway RPC’yi yoklar (--url/--token/--password ile geçersiz kılın).
• gateway status, betikleme için --no-probe, --deep, --require-rpc ve --json destekler.
• gateway status, algılayabildiğinde eski veya ek gateway hizmetlerini de gösterir (--deep, sistem düzeyinde taramalar ekler). Profil adlı OpenClaw hizmetleri birinci sınıf kabul edilir ve “extra” olarak işaretlenmez.
• gateway status, yerel CLI config’i eksik veya geçersiz olsa bile tanı için kullanılabilir kalır.
• gateway status, çözümlenmiş dosya günlük yolunu, CLI-karşı-hizmet config yolları/geçerlilik anlık görüntüsünü ve çözümlenmiş yoklama hedef URL’sini yazdırır.
• Geçerli komut yolunda gateway auth SecretRef’leri çözümlenmemişse gateway status --json, yalnızca yoklama bağlantısı/auth başarısız olduğunda rpc.authWarning bildirir (yoklama başarılıysa uyarılar bastırılır).
• Linux systemd kurulumlarında durum belirteci sapma denetimleri hem Environment= hem de EnvironmentFile= birim kaynaklarını içerir.
• gateway install|uninstall|start|stop|restart, betikleme için --json destekler (varsayılan çıktı insan dostu kalır).
• gateway install, varsayılan olarak Node çalışma zamanı kullanır; bun önerilmez (WhatsApp/Telegram hataları).
• gateway install seçenekleri: --port, --runtime, --token, --force, --json.

​

daemon

• daemon status
• daemon install
• daemon uninstall
• daemon start
• daemon stop
• daemon restart

• status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install: --port, --runtime <node|bun>, --token, --force, --json
• uninstall|start|stop|restart: --json

​

logs

• --limit <n>: döndürülecek en fazla günlük satırı sayısı
• --max-bytes <n>: günlük dosyasından okunacak en fazla bayt
• --follow: günlük dosyasını takip eder (tail -f tarzı)
• --interval <ms>: takip ederken ms cinsinden yoklama aralığı
• --local-time: zaman damgalarını yerel saatte görüntüler
• --json: satır sınırlı JSON verir
• --plain: yapılandırılmış biçimlendirmeyi devre dışı bırakır
• --no-color: ANSI renklerini devre dışı bırakır
• --url <url>: açık Gateway WebSocket URL’si
• --token <token>: Gateway belirteci
• --timeout <ms>: Gateway RPC zaman aşımı
• --expect-final: gerektiğinde son bir yanıt bekler

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color

• --url geçirirseniz CLI config veya ortam kimlik bilgilerini otomatik uygulamaz.
• Yerel loopback eşleştirme hataları, yapılandırılmış yerel günlük dosyasına geri döner; açık --url hedefleri için bu yapılmaz.

​

gateway <subcommand>

• gateway call <method> [--params <json>] [--url <url>] [--token <token>] [--password <password>] [--timeout <ms>] [--expect-final] [--json]
• gateway health
• gateway status
• gateway probe
• gateway discover
• gateway install|uninstall|start|stop|restart
• gateway run

• gateway status --deep, sistem düzeyinde hizmet taraması ekler. Daha derin çalışma zamanı yoklama ayrıntıları için gateway probe, health --verbose veya üst düzey status --deep kullanın.

• config.schema.lookup (bir config alt ağacını sığ bir şema düğümü, eşleşen ipucu meta verileri ve doğrudan alt öğe özetleriyle inceler)
• config.get (mevcut config anlık görüntüsünü + hash’i okur)
• config.set (doğrular + tam config’i yazar; iyimser eşzamanlılık için baseHash kullanın)
• config.apply (doğrular + config’i yazar + yeniden başlatır + uyandırır)
• config.patch (kısmi güncellemeyi birleştirir + yeniden başlatır + uyandırır)
• update.run (güncelleme + yeniden başlatma + uyandırma çalıştırır)

​

Modeller

openclaw models auth login --provider anthropic --method cli --set-default

​

models (kök)

• --status-json (models status --json için takma ad)
• --status-plain (models status --plain için takma ad)

​

models list

• --all
• --local
• --provider <name>
• --json
• --plain

​

models status

• --json
• --plain
• --check (çıkış 1=sona ermiş/eksik, 2=süresi dolmak üzere)
• --probe (yapılandırılmış auth profillerinin canlı yoklaması)
• --probe-provider <name>
• --probe-profile <id> (tekrarlı veya virgülle ayrılmış)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id>

​

models set <model>

​

models set-image <model>

​

models aliases list|add|remove

• list: --json, --plain
• add <alias> <model>
• remove <alias>

​

models fallbacks list|add|remove|clear

• list: --json, --plain
• add <model>
• remove <model>
• clear

​

models image-fallbacks list|add|remove|clear

• list: --json, --plain
• add <model>
• remove <model>
• clear

​

models scan

• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms>
• --concurrency <n>
• --no-probe
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

models auth add|login|login-github-copilot|setup-token|paste-token

• add: etkileşimli auth yardımcısı (sağlayıcı auth akışı veya token yapıştırma)
• login: --provider <name>, --method <method>, --set-default
• login-github-copilot: GitHub Copilot OAuth oturum açma akışı (--yes)
• setup-token: --provider <name>, --yes
• paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

• setup-token ve paste-token, token auth yöntemleri sunan sağlayıcılar için genel token komutlarıdır.
• setup-token, etkileşimli bir TTY gerektirir ve sağlayıcının token-auth yöntemini çalıştırır.
• paste-token, token değerini ister ve --profile-id belirtilmediğinde varsayılan olarak auth profil kimliği <provider>:manual kullanır.
• Anthropic setup-token / paste-token, eski/el ile OpenClaw yolu olarak yeniden kullanılabilir. Anthropic, OpenClaw kullanıcılarına bu yolun Claude hesabında Extra Usage gerektirdiğini bildirdi.

​

models auth order get|set|clear

• get: --provider <name>, --agent <id>, --json
• set: --provider <name>, --agent <id>, <profileIds...>
• clear: --provider <name>, --agent <id>

​

Sistem

​

system event

• --text <text>

• --mode <now|next-heartbeat>
• --json
• --url, --token, --timeout, --expect-final

​

system heartbeat last|enable|disable

• --json
• --url, --token, --timeout, --expect-final

​

system presence

• --json
• --url, --token, --timeout, --expect-final

​

Cron

• cron status [--json]
• cron list [--all] [--json] (varsayılan olarak tablo çıktısı; ham çıktı için --json kullanın)
• cron add (takma ad: create; --name ve tam olarak bir --at | --every | --cron ile tam olarak bir --system-event | --message yükü gerektirir)
• cron edit <id> (alanları yama olarak uygular)
• cron rm <id> (takma adlar: remove, delete)
• cron enable <id>
• cron disable <id>
• cron runs --id <id> [--limit <n>]
• cron run <id> [--due]

​

Düğüm ana makinesi

​

node

• node run --host <gateway-host> --port 18789
• node status
• node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
• node uninstall
• node stop
• node restart

• node, gateway auth bilgisini env/config içinden çözer (--token/--password bayrakları yok): OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, ardından gateway.auth.*. Yerel modda düğüm ana makinesi bilerek gateway.remote.* değerlerini yok sayar; gateway.mode=remote durumunda gateway.remote.*, uzak öncelik kurallarına göre katılır.
• Düğüm ana makinesi auth çözümü yalnızca OPENCLAW_GATEWAY_* env değişkenlerini dikkate alır.

​

Düğümler

• --url, --token, --timeout, --json

• nodes status [--connected] [--last-connected <duration>]
• nodes describe --node <id|name|ip>
• nodes list [--connected] [--last-connected <duration>]
• nodes pending
• nodes approve <requestId>
• nodes reject <requestId>
• nodes rename --node <id|name|ip> --name <displayName>
• nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
• nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (yalnızca mac)

• nodes camera list --node <id|name|ip>
• nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
• nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]

• nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
• nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
• nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]
• nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]
• nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]
• nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
• nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]
• nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]

• nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

​

Tarayıcı

• --url, --token, --timeout, --expect-final, --json
• --browser-profile <name>

• browser status
• browser start
• browser stop
• browser reset-profile
• browser tabs
• browser open <url>
• browser focus <targetId>
• browser close [targetId]
• browser profiles
• browser create-profile --name <name> [--color <hex>] [--cdp-url <url>] [--driver existing-session] [--user-data-dir <path>]
• browser delete-profile --name <name>

• browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
• browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]

• browser navigate <url> [--target-id <id>]
• browser resize <width> <height> [--target-id <id>]
• browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]
• browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
• browser press <key> [--target-id <id>]
• browser hover <ref> [--target-id <id>]
• browser drag <startRef> <endRef> [--target-id <id>]
• browser select <ref> <values...> [--target-id <id>]
• browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
• browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
• browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
• browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
• browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
• browser console [--level <error|warn|info>] [--target-id <id>]
• browser pdf [--target-id <id>]

​

Sesli arama

​

voicecall

• voicecall call --to <phone> --message <text> [--mode notify|conversation]
• voicecall start --to <phone> [--message <text>] [--mode notify|conversation]
• voicecall continue --call-id <id> --message <text>
• voicecall speak --call-id <id> --message <text>
• voicecall end --call-id <id>
• voicecall status --call-id <id>
• voicecall tail [--file <path>] [--since <n>] [--poll <ms>]
• voicecall latency [--file <path>] [--last <n>]
• voicecall expose [--mode off|serve|funnel] [--path <path>] [--port <port>] [--serve-path <path>]

​

Belgelerde arama

​

docs

​

docs [query...]

​

TUI

​

tui

• --url <url>
• --token <token>
• --password <password>
• --session <key>
• --deliver
• --thinking <level>
• --message <text>
• --timeout-ms <ms> (varsayılan agents.defaults.timeoutSeconds)
• --history-limit <n>