Ana içeriğe atla
Gateway, / ile başlayan bağımsız iletiler olarak gönderilen komutları işler. Yalnızca ana makineye yönelik bash komutları ! <cmd> kullanır (/bash <cmd> diğer adıyla). Bir konuşma bir ACP oturumuna bağlı olduğunda, normal metin ACP harness’ına yönlendirilir. Gateway yönetim komutları yerel kalır: /acp ... her zaman OpenClaw komut işleyicisine ulaşır; /status ve /unfocus ise yüzey için komut işleme etkinleştirildiğinde yerel kalır.

Üç komut türü

Commands

Gateway tarafından işlenen bağımsız /... iletileri. İletideki tek içerik olarak gönderilmelidir.

Directives

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — model görmeden önce iletiden çıkarılır. Tek başına gönderildiğinde oturum ayarlarını kalıcılaştırır; başka metinle gönderildiğinde satır içi ipuçları olarak davranır.

Inline shortcuts

/help, /commands, /status, /whoami — hemen çalışır ve model kalan metni görmeden önce çıkarılır. Yalnızca yetkili gönderenler.
  • Yönergeler, model görmeden önce iletiden çıkarılır.
  • Yalnızca yönerge iletilerinde (ileti yalnızca yönergelerden oluşuyorsa), bunlar oturumda kalıcı olur ve bir onay yanıtı döndürür.
  • Başka metin içeren normal sohbet iletilerinde, satır içi ipuçları olarak davranır ve oturum ayarlarını kalıcılaştırmaz.
  • Yönergeler yalnızca yetkili gönderenler için geçerlidir. commands.allowFrom ayarlanmışsa kullanılan tek izin listesi odur; aksi halde yetkilendirme, kanal izin listeleri/eşleştirme ve commands.useAccessGroups üzerinden gelir. Yetkisiz gönderenler için yönergeler düz metin olarak ele alınır.

Yapılandırma

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    mcp: false,
    plugins: false,
    debug: false,
    restart: true,
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw",
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}
commands.text
boolean
varsayılan:"true"
Sohbet iletilerinde /... ayrıştırmasını etkinleştirir. Yerel komutları olmayan yüzeylerde (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), metin komutları false olarak ayarlansa bile çalışır.
commands.native
boolean | "auto"
varsayılan:"\"auto\""
Yerel komutları kaydeder. Otomatik: Discord/Telegram için açık; Slack için kapalı; yerel desteği olmayan sağlayıcılar için yok sayılır. Kanal bazında channels.<provider>.commands.native ile geçersiz kılın. Discord’da false, eğik çizgi komutu kaydını atlar; daha önce kaydedilmiş komutlar kaldırılana kadar görünür kalabilir.
commands.nativeSkills
boolean | "auto"
varsayılan:"\"auto\""
Desteklendiğinde skill komutlarını yerel olarak kaydeder. Otomatik: Discord/Telegram için açık; Slack için kapalı. channels.<provider>.commands.nativeSkills ile geçersiz kılın.
commands.bash
boolean
varsayılan:"false"
Ana makine kabuk komutlarını çalıştırmak için ! <cmd> kullanımını etkinleştirir (/bash <cmd> diğer adı). tools.elevated izin listeleri gerektirir.
commands.bashForegroundMs
number
varsayılan:"2000"
Bash’in arka plan moduna geçmeden önce ne kadar bekleyeceği (0 hemen arka plana alır).
commands.config
boolean
varsayılan:"false"
/config komutunu etkinleştirir (openclaw.json okur/yazar). Yalnızca sahip.
commands.mcp
boolean
varsayılan:"false"
/mcp komutunu etkinleştirir (mcp.servers altında OpenClaw tarafından yönetilen MCP yapılandırmasını okur/yazar). Yalnızca sahip.
commands.plugins
boolean
varsayılan:"false"
/plugins komutunu etkinleştirir (Plugin keşfi/durumu ve yükleme + etkinleştirme/devre dışı bırakma). Yazma işlemleri için yalnızca sahip.
commands.debug
boolean
varsayılan:"false"
/debug komutunu etkinleştirir (yalnızca çalışma zamanı yapılandırma geçersiz kılmaları). Yalnızca sahip.
commands.restart
boolean
varsayılan:"true"
/restart komutunu ve Gateway yeniden başlatma araç eylemlerini etkinleştirir.
commands.ownerAllowFrom
string[]
Yalnızca sahip komut yüzeyleri için açık sahip izin listesi. commands.allowFrom ve DM eşleştirme erişiminden ayrıdır.
channels.<channel>.commands.enforceOwnerForCommands
boolean
varsayılan:"false"
Kanal bazında: yalnızca sahip komutları için sahip kimliği gerektirir. true olduğunda, gönderen commands.ownerAllowFrom ile eşleşmeli veya dahili operator.admin kapsamına sahip olmalıdır. Joker karakterli bir allowFrom girdisi yeterli değildir.
commands.ownerDisplay
"raw" | "hash"
Sistem isteminde sahip kimliklerinin nasıl görüneceğini denetler.
commands.ownerDisplaySecret
string
commands.ownerDisplay: "hash" olduğunda kullanılan HMAC sırrı.
commands.allowFrom
object
Komut yetkilendirmesi için sağlayıcı bazında izin listesi. Yapılandırıldığında, komutlar ve yönergeler için tek yetkilendirme kaynağıdır. Genel varsayılan için "*" kullanın; sağlayıcıya özgü anahtarlar bunu geçersiz kılar.
commands.useAccessGroups
boolean
varsayılan:"true"
commands.allowFrom ayarlanmadığında komutlar için izin listelerini/ilkeleri zorunlu kılar.

Komut listesi

Komutlar üç kaynaktan gelir:
  • Çekirdek yerleşikler: src/auto-reply/commands-registry.shared.ts
  • Oluşturulmuş dock komutları: src/auto-reply/commands-registry.data.ts
  • Plugin komutları: Plugin registerCommand() çağrıları
Kullanılabilirlik, yapılandırma bayraklarına, kanal yüzeyine ve yüklü/etkin Plugin’lere bağlıdır.

Çekirdek komutlar

KomutAçıklama
/new [model]Geçerli oturumu arşivleyip yeni bir oturum başlatır
/reset [soft [message]]Geçerli oturumu yerinde sıfırlar. soft transcript’i korur, yeniden kullanılan CLI arka uç oturum kimliklerini bırakır ve başlangıcı yeniden çalıştırır
/name <title>Geçerli oturuma ad verir veya adını değiştirir. Geçerli adı ve bir öneriyi görmek için başlığı atlayın
/compact [instructions]Oturum bağlamını sıkıştırır. Bkz. Compaction
/stopGeçerli çalıştırmayı iptal eder
/session idle <duration|off>İş parçacığı bağlama boşta kalma süresi bitimini yönetir
/session max-age <duration|off>İş parçacığı bağlama maksimum yaş süresi bitimini yönetir
/export-session [path]Geçerli oturumu HTML olarak dışa aktarır. Diğer ad: /export
/export-trajectory [path]Geçerli oturum için bir JSONL trajectory paketi dışa aktarır. Diğer ad: /trajectory
Control UI, yeni bir dashboard oturumu oluşturmak ve ona geçmek için yazılan /new komutunu yakalar; ancak session.dmScope: "main" yapılandırılmışsa ve geçerli üst öğe ajanın ana oturumuysa, bu durumda /new ana oturumu yerinde sıfırlar. Yazılan /reset yine Gateway’in yerinde sıfırlamasını çalıştırır. Sabitlenmiş bir oturum model seçimini temizlemek istediğinizde /model default kullanın.
KomutAçıklama
/think <level|default>Düşünme düzeyini ayarlar veya oturum geçersiz kılmasını temizler. Diğer adlar: /thinking, /t
/verbose on|off|fullAyrıntılı çıktıyı açar/kapatır. Diğer ad: /v
/trace on|offGeçerli oturum için Plugin trace çıktısını açar/kapatır
/fast [status|auto|on|off|default]Hızlı modu gösterir, ayarlar veya temizler
/reasoning [on|off|stream]Akıl yürütme görünürlüğünü açar/kapatır. Diğer ad: /reason
/elevated [on|off|ask|full]Yükseltilmiş modu açar/kapatır. Diğer ad: /elev
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>Exec varsayılanlarını gösterir veya ayarlar
/login [codex|openai|openai-codex]Özel sohbetten veya Web UI oturumundan Codex/OpenAI oturum açmayı eşleştirir. Yalnızca sahip/yönetici
/model [name|#|status]Modeli gösterir veya ayarlar
/models [provider] [page] [limit=<n>|all]Yapılandırılmış/kimlikle kullanılabilir sağlayıcıları veya modelleri listeler
/queue <mode>Etkin çalıştırma kuyruk davranışını yönetir. Bkz. Kuyruk ve Kuyruk yönlendirme
/steer <message>Etkin çalıştırmaya yönlendirme ekler. Diğer ad: /tell. Bkz. Yönlendir
  • /verbose hata ayıklama içindir — normal kullanımda kapalı tutun.
  • /trace yalnızca Plugin’e ait trace/hata ayıklama satırlarını gösterir; normal ayrıntılı gevezelik kapalı kalır.
  • /fast auto|on|off bir oturum geçersiz kılmasını kalıcılaştırır; temizlemek için Oturumlar UI inherit seçeneğini kullanın.
  • /fast sağlayıcıya özgüdür: OpenAI/Codex bunu service_tier=priority ile eşler; doğrudan Anthropic istekleri bunu service_tier=auto veya standard_only ile eşler.
  • /reasoning, /verbose ve /trace grup ayarlarında risklidir — dahili akıl yürütmeyi veya Plugin tanılamalarını açığa çıkarabilir. Grup sohbetlerinde bunları kapalı tutun.
  • /model yeni modeli hemen oturumda kalıcılaştırır.
  • Ajan boştaysa, sonraki çalıştırma bunu hemen kullanır.
  • Bir çalıştırma etkinse, geçiş beklemede olarak işaretlenir ve sonraki temiz yeniden deneme noktasında uygulanır.
KomutAçıklama
/helpKısa yardım özetini gösterir
/commandsOluşturulmuş komut kataloğunu gösterir
/tools [compact|verbose]Geçerli ajanın şu anda ne kullanabileceğini gösterir
/statusYürütme/çalışma zamanı durumunu, Gateway ve sistem çalışma süresini, Plugin sağlığını ve sağlayıcı kullanımını/kotasını gösterir
/status pluginsAyrıntılı Plugin sağlığını gösterir: yükleme hataları, karantinalar, kanal arızaları, bağımlılık sorunları, uyumluluk bildirimleri
/goal [status|start|pause|resume|complete|block|clear] ...Geçerli oturumun kalıcı hedefini yönetir
/diagnostics [note]Yalnızca sahip destek raporu akışı. Her seferinde exec onayı ister
/crestodian <request>Sahip DM’sinden Crestodian kurulum ve onarım yardımcısını çalıştırır
/tasksGeçerli oturum için etkin/yakın tarihli arka plan görevlerini listeler
/context [list|detail|map|json]Bağlamın nasıl birleştirildiğini açıklar
/whoamiGönderen kimliğinizi gösterir. Diğer ad: /id
/usage off|tokens|full|reset|costYanıt başına kullanım alt bilgisini denetler (reset/inherit/clear/default, yapılandırılmış varsayılanı yeniden devralmak için oturum geçersiz kılmasını temizler) veya yerel bir maliyet özeti yazdırır
KomutAçıklama
/skill <name> [input]Ada göre bir skill çalıştırır
/allowlist [list|add|remove] ...İzin listesi girdilerini yönetir. Yalnızca metin
/approve <id> <decision>Exec veya Plugin onay istemlerini çözümler
/btw <question>Oturum bağlamını değiştirmeden yan soru sorar. Diğer ad: /side. Bkz. BTW
KomutAçıklama
/subagents list|log|infoGeçerli oturum için alt ajan çalıştırmalarını inceleyin
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|helpACP oturumlarını ve çalışma zamanı seçeneklerini yönetin. Çalışma zamanı kontrolleri için harici sahip veya dahili Gateway yönetici kimliği gerekir
/focus <target>Geçerli Discord iş parçacığını veya Telegram konusunu bir oturum hedefine bağlayın
/unfocusGeçerli iş parçacığı bağını kaldırın
/agentsGeçerli oturum için iş parçacığına bağlı ajanları listeleyin
KomutGerektirirAçıklama
/config show|get|set|unsetcommands.config: trueopenclaw.json dosyasını okuyun veya yazın. Yalnızca sahip
/mcp show|get|set|unsetcommands.mcp: trueOpenClaw tarafından yönetilen MCP sunucu yapılandırmasını okuyun veya yazın. Yalnızca sahip
/plugins list|inspect|show|get|install|enable|disablecommands.plugins: truePlugin durumunu inceleyin veya değiştirin. Yazmalar için yalnızca sahip. Takma ad: /plugin
/debug show|set|unset|resetcommands.debug: trueYalnızca çalışma zamanı yapılandırma geçersiz kılmaları. Yalnızca sahip
/restartcommands.restart: true (varsayılan)OpenClaw’u yeniden başlatın
/send on|off|inheritsahipGönderme ilkesini ayarlayın
KomutAçıklama
/tts on|off|status|chat|latest|provider|limit|summary|audio|helpTTS’yi kontrol edin. Bkz. TTS
/activation mention|alwaysGrup etkinleştirme modunu ayarlayın
/bash <command>Bir ana makine kabuğu komutu çalıştırın. Takma ad: ! <command>. commands.bash: true gerektirir
!poll [sessionId]Bir arka plan bash işini kontrol edin
!stop [sessionId]Bir arka plan bash işini durdurun

Dock komutları

Dock komutları, etkin oturumun yanıt rotasını başka bir bağlantılı kanala geçirir. Kurulum ve sorun giderme için bkz. Kanal dock işlemi. Yerel komut desteği olan kanal Plugin’lerinden oluşturulur:
  • /dock-discord (takma ad: /dock_discord)
  • /dock-mattermost (takma ad: /dock_mattermost)
  • /dock-slack (takma ad: /dock_slack)
  • /dock-telegram (takma ad: /dock_telegram)
Dock komutları session.identityLinks gerektirir. Kaynak gönderen ve hedef eş aynı kimlik grubunda olmalıdır.

Paketli Plugin komutları

KomutAçıklama
/dreaming [on|off|status|help]Bellek Dreaming’ini açıp kapatın (sahip veya Gateway yöneticisi). Bkz. Dreaming
/pair [qr|status|pending|approve|cleanup|notify]Cihaz eşleştirmeyi yönetin. Bkz. Eşleştirme
/phone status|arm ...|disarmYüksek riskli telefon düğümü komutlarını geçici olarak etkinleştirin
/voice status|list|set <voiceId>Talk ses yapılandırmasını yönetin. Discord yerel adı: /talkvoice
/card ...LINE zengin kart ön ayarları gönderin. Bkz. LINE
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skillsCodex uygulama sunucusu harness’ını kontrol edin. Bkz. Codex harness
Yalnızca QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Skill komutları

Kullanıcının çağırabileceği Skills eğik çizgi komutları olarak sunulur:
  • /skill <name> [input] genel giriş noktası olarak her zaman çalışır.
  • Skills doğrudan komutlar olarak kaydolabilir (ör. OpenProse için /prose).
  • Yerel skill komutu kaydı commands.nativeSkills ve channels.<provider>.commands.nativeSkills tarafından kontrol edilir.
  • Adlar a-z0-9_ biçimine temizlenir (en fazla 32 karakter); çakışmalar sayısal son ekler alır.
Varsayılan olarak, skill komutları modele normal bir istek olarak yönlendirilir.Skills, doğrudan bir araca yönlendirmek için command-dispatch: tool bildirebilir (deterministik, model katılımı yok). Örnek: /prose (OpenProse Plugin’i) — bkz. OpenProse.
Discord, dinamik seçenekler için otomatik tamamlama ve gerekli argümanlar atlandığında düğme menüleri kullanır. Telegram ve Slack, seçenekleri olan komutlar için düğme menüsü gösterir. Dinamik seçimler hedef oturum modeline göre çözümlenir, bu nedenle /think düzeyleri gibi modele özgü seçenekler oturumun /model geçersiz kılmasını izler.

/tools — ajanın şu anda kullanabilecekleri

/tools bir çalışma zamanı sorusunu yanıtlar: bu ajanın şu anda bu konuşmada neleri kullanabileceği — statik bir yapılandırma kataloğu değil.
/tools         # kompakt görünüm
/tools verbose # kısa açıklamalarla
Sonuçlar oturum kapsamındadır. Ajanı, kanalı, iş parçacığını, gönderen yetkilendirmesini veya modeli değiştirmek çıktıyı değiştirebilir. Profil ve geçersiz kılma düzenleme için Control UI Araçlar panelini veya yapılandırma yüzeylerini kullanın.

/model — model seçimi

/model             # model seçiciyi göster
/model list        # aynı
/model 3           # seçiciden numarayla seç
/model openai/gpt-5.4
/model opus@anthropic:default
/model default     # oturum model seçimini temizle
/model status      # uç nokta ve API modu ile ayrıntılı görünüm
Discord’da, /model ve /models sağlayıcı ve model açılır menüleriyle etkileşimli bir seçici açar. Seçici, provider/* girdileri dahil olmak üzere agents.defaults.models ayarına uyar.

/config — disk üzerindeki yapılandırma yazmaları

Yalnızca sahip. Varsayılan olarak devre dışıdır — commands.config: true ile etkinleştirin.
/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix
Yapılandırma yazmadan önce doğrulanır. Geçersiz değişiklikler reddedilir. /config güncellemeleri yeniden başlatmalar arasında kalıcıdır.

/mcp — MCP sunucu yapılandırması

Yalnızca sahip. Varsayılan olarak devre dışıdır — commands.mcp: true ile etkinleştirin.
/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7
/mcp, yapılandırmayı gömülü ajan proje ayarlarında değil, OpenClaw yapılandırmasında saklar.

/debug — yalnızca çalışma zamanı geçersiz kılmaları

Yalnızca sahip. Varsayılan olarak devre dışıdır — commands.debug: true ile etkinleştirin. Geçersiz kılmalar yeni yapılandırma okumalarına hemen uygulanır ancak diske yazılmaz.
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset

/plugins — Plugin yönetimi

Yazmalar için yalnızca sahip. Varsayılan olarak devre dışıdır — commands.plugins: true ile etkinleştirin.
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
/plugins install ./path/to/plugin
/plugins enable|disable, Plugin yapılandırmasını günceller ve yeni ajan turları için Gateway Plugin çalışma zamanını sıcak yeniden yükler. /plugins install, Plugin kaynak modülleri değiştiği için yönetilen Gateway’leri otomatik olarak yeniden başlatır.

/trace — Plugin izleme çıktısı

/trace          # geçerli izleme durumunu göster
/trace on
/trace off
/trace, tam ayrıntılı mod olmadan oturum kapsamlı Plugin izleme/hata ayıklama satırlarını gösterir. /debug (çalışma zamanı geçersiz kılmaları) veya /verbose (normal araç çıktısı) yerine geçmez.

/btw — yan sorular

/btw, geçerli oturum bağlamı hakkında hızlı bir yan sorudur. Takma ad: /side.
/btw what are we doing right now?
/side what changed while the main run continued?
Normal bir iletiden farklı olarak:
  • Geçerli oturumu arka plan bağlamı olarak kullanır.
  • Codex harness oturumlarında, geçici bir Codex yan iş parçacığı olarak çalışır.
  • Gelecekteki oturum bağlamını değiştirmez.
  • Transkript geçmişine yazılmaz.
Tam davranış için bkz. BTW yan soruları.

Yüzey notları

  • Metin komutları: normal sohbet oturumunda çalışır (DM’ler main paylaşır, grupların kendi oturumu vardır).
  • Yerel Discord komutları: agent:<agentId>:discord:slash:<userId>
  • Yerel Slack komutları: agent:<agentId>:slack:slash:<userId> (channels.slack.slashCommand.sessionPrefix ile önek yapılandırılabilir)
  • Yerel Telegram komutları: telegram:slash:<userId> (sohbet oturumunu CommandTargetSessionKey üzerinden hedefler)
  • /login codex, cihaz eşleştirme kodlarını yalnızca özel sohbet veya Web UI yanıt yolları üzerinden gönderir. Telegram grup/konu çağrıları bunun yerine sahibinden bota DM göndermesini ister.
  • /stop, geçerli çalıştırmayı iptal etmek için etkin sohbet oturumunu hedefler.
channels.slack.slashCommand, tek bir /openclaw tarzı komutu destekler. commands.native: true ile her yerleşik komut için bir Slack eğik çizgi komutu oluşturun. Slack /status komutunu ayırdığı için /agentstatus kaydedin (/status değil). Metin /status yine de Slack mesajlarında çalışır.
  • İzin listesindeki gönderenlerden gelen yalnızca komut içeren mesajlar hemen işlenir (kuyruk + model atlanır).
  • Satır içi kısayollar (/help, /commands, /status, /whoami) normal mesajların içine gömülü olarak da çalışır ve model kalan metni görmeden önce çıkarılır.
  • Yetkisiz yalnızca komut içeren mesajlar sessizce yok sayılır; satır içi /... belirteçleri düz metin olarak ele alınır.
  • Komutlar, komut ile argümanlar arasında isteğe bağlı bir : kabul eder (/think: high, /send: on).
  • /new <model> bir model takma adı, provider/model veya sağlayıcı adı (bulanık eşleşme) kabul eder; eşleşme yoksa metin ileti gövdesi olarak ele alınır.
  • /allowlist add|remove, commands.config: true gerektirir ve kanal configWrites ayarına uyar.

Sağlayıcı kullanımı ve durumu

  • Sağlayıcı kullanımı/kotası (ör. “Claude %80 kaldı”), kullanım izleme etkinleştirildiğinde geçerli model sağlayıcısı için /status içinde gösterilir.
  • /status içindeki Token/önbellek satırları, canlı oturum anlık görüntüsü seyrek olduğunda en son transkript kullanım girdisine geri dönebilir.
  • Yürütme ve çalışma zamanı: /status, etkin sandbox yolu için Execution, oturumu kimin çalıştırdığı için Runtime bildirir: OpenClaw Default, OpenAI Codex, bir CLI arka ucu veya bir ACP arka ucu.
  • Yanıt başına token/maliyet: /usage off|tokens|full tarafından kontrol edilir.
  • /model status, kullanımla değil modeller/kimlik doğrulama/uç noktalarla ilgilidir.

İlgili

Skills

Skill eğik çizgi komutlarının nasıl kaydedildiği ve kapılandığı.

Skills oluşturma

Kendi eğik çizgi komutunu kaydeden bir skill oluşturun.

BTW

Oturum bağlamını değiştirmeden yan sorular.

Steer

Ajanı çalıştırma sırasında /steer ile yönlendirin.