Skip to main content
Gateway, / ile başlayan bağımsız iletiler olarak gönderilen komutları işler. Yalnızca ana makinede çalışan bash komutları ! <cmd> kullanır (/bash <cmd> bunun diğer adıdır). Bir konuşma bir ACP oturumuna bağlandığında normal metin ACP çalıştırma çerçevesine yönlendirilir. Gateway yönetim komutları yerel kalır: /acp ... her zaman OpenClaw komut işleyicisine ulaşır; ayrıca yüzeyde komut işleme etkin olduğunda /status ve /unfocus yerel kalır.

Üç komut türü

Komutlar

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

Yönergeler

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — model iletiyi görmeden önce iletiden çıkarılır. Tek başına gönderildiğinde oturum ayarlarını kalıcı hâle getirir; başka metinlerle gönderildiğinde satır içi ipuçları olarak işlev görür.

Satır içi kısayollar

/help, /commands, /status, /whoami — hemen çalıştırılır ve model kalan metni görmeden önce iletiden çıkarılır. Yalnızca yetkili gönderenler içindir.
  • Yönergeler, model iletiyi görmeden önce iletiden çıkarılır.
  • Yalnızca yönerge içeren iletilerde (ileti yalnızca yönergelerden oluşur) oturumda kalıcı hâle gelir ve bir onay yanıtı döndürür.
  • Başka metinler içeren normal sohbet iletilerinde satır içi ipuçları olarak işlev görür ve oturum ayarlarını kalıcı hâle getirmez.
  • Yönergeler yalnızca yetkili gönderenler için geçerlidir. commands.allowFrom ayarlanmışsa kullanılan tek izin listesi budur; aksi takdirde yetkilendirme kanal izin listelerinden, eşleştirmeden ve her zaman etkin erişim grubu uygulamasından gelir. Yetkisiz gönderenlerin yönergeleri düz metin olarak işlenir.

Yapılandırma

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), false olarak ayarlandığında bile metin komutları çalışır.
boolean | "auto"
varsayılan:"\"auto\""
Yerel komutları kaydeder. Otomatik: Discord/Telegram için açık, Slack için kapalıdır; yerel desteği olmayan sağlayıcılarda yok sayılır. Kanal başına channels.<provider>.commands.native ile geçersiz kılın. Discord’da false, eğik çizgi komutlarının kaydını atlar; önceden kaydedilmiş komutlar kaldırılana kadar görünür kalabilir.
boolean | "auto"
varsayılan:"\"auto\""
Desteklendiğinde beceri komutlarını yerel olarak kaydeder. Otomatik: Discord/Telegram için açık, Slack için kapalıdır. channels.<provider>.commands.nativeSkills ile geçersiz kılın.
boolean
varsayılan:"false"
Ana makine kabuk komutlarını çalıştırmak için ! <cmd> özelliğini etkinleştirir (/bash <cmd> diğer adıdır). tools.elevated izin listelerini gerektirir.
number
varsayılan:"2000"
Bash’in arka plan moduna geçmeden önce ne kadar bekleyeceğini belirler (0 hemen arka plana geçirir).
boolean
varsayılan:"false"
/config özelliğini etkinleştirir (openclaw.json dosyasını okur/yazar). Yalnızca sahip içindir.
boolean
varsayılan:"false"
/mcp özelliğini etkinleştirir (mcp.servers altındaki OpenClaw tarafından yönetilen MCP yapılandırmasını okur/yazar). Yalnızca sahip içindir.
boolean
varsayılan:"false"
/plugins özelliğini etkinleştirir (plugin keşfi/durumu ile kurma ve etkinleştirme/devre dışı bırakma). Yazma işlemleri yalnızca sahip içindir.
boolean
varsayılan:"false"
/debug özelliğini etkinleştirir (yalnızca çalışma zamanı yapılandırması geçersiz kılmaları). Yalnızca sahip içindir.
boolean
varsayılan:"true"
/restart ve harici SIGUSR1 yeniden başlatma isteklerini etkinleştirir.
string[]
Yalnızca sahibe özel komut yüzeyleri için açık sahip izin listesi. commands.allowFrom ve DM eşleştirme erişiminden ayrıdır.
boolean
varsayılan:"false"
Kanal başına: yalnızca sahibe özel 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.
"raw" | "hash"
Sahip kimliklerinin sistem isteminde nasıl görüneceğini denetler.
string
commands.ownerDisplay: "hash" olduğunda kullanılan HMAC gizli anahtarı.
object
Komut yetkilendirmesi için sağlayıcı başına 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 özel anahtarlar bunu geçersiz kılar.

Komut listesi

Komutlar üç kaynaktan gelir:
  • Yerleşik temel komutlar: src/auto-reply/commands-registry.shared.ts
  • Oluşturulan 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 kurulu/etkin pluginlere bağlıdır.

Temel komutlar

Açıkça belirtilen /export-session yolları, çalışma alanındaki mevcut dosyaların üzerine yazar. Çakışmaya karşı güvenli bir dosya adı oluşturmak için yolu belirtmeyin.
Control UI, yeni bir pano oturumu oluşturup buna geçmek için yazılan /new komutunu yakalar; ancak session.dmScope: "main" yapılandırılmışsa ve geçerli üst öğe aracının ana oturumuysa /new ana oturumu yerinde sıfırlar. Yazılan /reset yine de Gateway’in yerinde sıfırlama işlemini çalıştırır. Sabitlenmiş bir oturum modeli seçimini temizlemek istediğinizde /model default kullanın.
  • /verbose hata ayıklama içindir — normal kullanımda kapalı tutun.
  • /trace yalnızca pluginin sahip olduğu izleme/hata ayıklama satırlarını gösterir; normal ayrıntılı mesajlar kapalı kalır.
  • /fast auto|on|off bir oturum geçersiz kılmasını kalıcı hâle getirir; temizlemek için Oturumlar kullanıcı arayüzündeki inherit seçeneğini kullanın.
  • /fast sağlayıcıya özeldir: 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 ortamlarında risklidir — dahili akıl yürütmeyi veya plugin tanılamalarını açığa çıkarabilir. Bunları grup sohbetlerinde kapalı tutun.
  • /model yeni modeli oturumda hemen kalıcı hâle getirir.
  • Aracı boşta olduğunda sonraki çalıştırma bunu hemen kullanır.
  • Bir çalıştırma etkinse değişiklik beklemede olarak işaretlenir ve bir sonraki temiz yeniden deneme noktasında uygulanır.

Yerleştirme komutları

Yerleştirme komutları, etkin oturumun yanıt rotasını bağlantılı başka bir kanala geçirir. Kurulum ve sorun giderme için Kanal yerleştirme bölümüne bakın. Yerel komut desteğine sahip kanal pluginlerinden oluşturulur:
  • /dock-discord (diğer ad: /dock_discord)
  • /dock-mattermost (diğer ad: /dock_mattermost)
  • /dock-slack (diğer ad: /dock_slack)
  • /dock-telegram (diğer ad: /dock_telegram)
Yerleştirme komutları session.identityLinks gerektirir. Kaynak gönderen ve hedef eş aynı kimlik grubunda olmalıdır.

Birlikte gelen plugin komutları

Yalnızca QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Skill komutları

Kullanıcı tarafından çağrılabilen skill’ler eğik çizgi komutları olarak sunulur:
  • /skill <name> [input] genel giriş noktası olarak her zaman çalışır.
  • Skills doğrudan komut olarak kaydolabilir (ör. OpenProse için /prose).
  • Yerel skill komutu kaydı, commands.nativeSkills ve channels.<provider>.commands.nativeSkills tarafından denetlenir.
  • Adlar a-z0-9_ biçimine dönüştürülür (en fazla 32 karakter); çakışmalara sayısal son ekler eklenir.
Varsayılan olarak skill komutları, normal bir istek olarak modele yönlendirilir.Skills doğrudan bir araca yönlendirmek için command-dispatch: tool bildirebilir (belirlenimci, model katılımı yoktur). Örnek: /prose (OpenProse plugini) — bkz. OpenProse.
Discord, gerekli bağımsız değişkenler belirtilmediğinde dinamik seçenekler için otomatik tamamlamayı ve düğme menülerini kullanır. Telegram ve Slack, seçenekleri olan komutlar için bir düğme menüsü gösterir. Dinamik seçenekler 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 kullanabilecekleri — statik bir yapılandırma kataloğu değildir.
Sonuçlar oturum kapsamındadır. Ajanın, kanalın, ileti dizisinin, gönderen yetkilendirmesinin veya modelin değiştirilmesi çıktıyı değiştirebilir. Profil ve geçersiz kılma düzenlemeleri için Control UI Araçlar panelini veya yapılandırma yüzeylerini kullanın.

/model: model seçimi

Discord’da /model ve /models, sağlayıcı ve model açılır listelerini içeren etkileşimli bir seçici açar. Seçici, provider/* girdileri dâhil olmak üzere agents.defaults.modelPolicy.allow ayarına uyar. Açık bir izin listesi olmadığında model girdileri ve diğer adlar seçimi kısıtlamaz.

/config: disk üzerindeki yapılandırmaya yazma

Yalnızca sahip. Varsayılan olarak devre dışıdır — commands.config: true ile etkinleştirin.
Yapılandırma, yazma işleminden önce doğrulanır. Geçersiz değişiklikler reddedilir. /config güncellemeleri yeniden başlatmalar arasında kalıcıdır.

/mcp: MCP sunucusu yapılandırması

Yalnızca sahip. Varsayılan olarak devre dışıdır — commands.mcp: true ile etkinleştirin.
/mcp, yapılandırmayı gömülü ajan proje ayarlarında değil OpenClaw yapılandırmasında saklar. /mcp show; kimlik bilgileri içeren alanları, tanınan kimlik bilgisi bayrağı değerlerini ve bilinen gizli bilgi biçimindeki bağımsız değişkenleri sansürler. Bir gruptan çalıştırıldığında yapılandırma sahibe özel olarak gönderilir; sahibe ulaşan özel bir rota yoksa komut güvenli biçimde başarısız olur ve sahibin doğrudan sohbetten yeniden denemesini ister.

/debug: yalnızca çalışma zamanına yönelik 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.

/plugins: plugin yönetimi

Yazma işlemleri yalnızca sahibe açıktır. Varsayılan olarak devre dışıdır — commands.plugins: true ile etkinleştirin.
/plugins enable|disable, plugin yapılandırmasını günceller ve yeni ajan turları için Gateway plugin çalışma zamanını çalışırken 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. Güvenilir ClawHub ve resmî katalog kurulumları ek onay gerektirmez. Rastgele npm, git, arşiv, npm-pack: ve yerel yol kaynakları bir köken uyarısı gösterir ve kaynağı inceledikten sonra sonda --force bulunmasını gerektirir. Bu bayrak kaynağı onaylar ve mevcut bir kurulumun değiştirilmesine izin verir; security.installPolicy veya kurucu güvenlik denetimlerini atlamaz. Risk uyarıları bulunan ClawHub sürümleri yine de yalnızca kabukta kullanılabilen ayrı --acknowledge-clawhub-risk bayrağını gerektirir. Pazar yeri, bağlantılı ve sabitlenmiş kurulumlar da yalnızca kabuktan yapılabilir.

/trace: plugin izleme çıktısı

/trace, tam ayrıntılı mod olmadan oturum kapsamındaki 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. Diğer ad: /side.
Normal bir mesajdan farklı olarak:
  • Geçerli oturumu arka plan bağlamı olarak kullanır.
  • Codex test düzeneği oturumlarında, geçici bir Codex yan ileti dizisi olarak çalışır.
  • Gelecekteki oturum bağlamını değiştirmez.
  • Transkript geçmişine yazılmaz.
Tüm davranış için BTW yan soruları bölümüne bakın.

Yüzey notları

  • Metin komutları: normal sohbet oturumunda çalışır (DM’ler main öğesini paylaşır, grupların kendi oturumu vardır).
  • Yerel Discord komutları: agent:<agentId>:discord:slash:<userId>
  • Yerel Slack komutları: agent:<agentId>:slack:slash:<userId> (ön ek channels.slack.slashCommand.sessionPrefix aracılığıyla yapılandırılabilir)
  • Yerel Telegram komutları: telegram:slash:<userId> (CommandTargetSessionKey aracılığıyla sohbet oturumunu 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 sahibin 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 öğesini ayırdığı için /agentstatus öğesini (/status değil) kaydedin. /status metni Slack mesajlarında çalışmaya devam eder.
  • İzin verilenler listesindeki göndericilerden 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 yerleştirildiğinde de çalışır ve model kalan metni görmeden önce kaldırılır.
  • Yetkisiz, yalnızca komut içeren mesajlar sessizce yok sayılır; satır içi /... belirteçleri düz metin olarak değerlendirilir.
  • Komutlar, komut ile bağımsız değişkenler arasında isteğe bağlı bir : kabul eder (/think: high, /send: on).
  • /new <model>; bir model takma adını, provider/model veya bir sağlayıcı adını (bulanık eşleşme) kabul eder; eşleşme bulunamazsa metin mesaj gövdesi olarak değerlendirilir.
  • /allowlist add|remove, commands.config: true gerektirir ve kanalın configWrites ayarına uyar.

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

  • Sağlayıcı kullanımı/kotası (ör. “Claude %80 kaldı”), kullanım takibi etkinleştirildiğinde geçerli model sağlayıcısı için /status içinde gösterilir.
  • /status içindeki belirteç/ö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 korumalı alan yolu için Execution; oturumu kimin çalıştırdığı içinse Runtime bildirir: OpenClaw Default, OpenAI Codex, bir CLI arka ucu veya bir ACP arka ucu.
  • Yanıt başına belirteçler/maliyet: /usage off|tokens|full tarafından denetlenir.
  • /model status; kullanımla değil, modeller/kimlik doğrulama/uç noktalarla ilgilidir.

İlgili

Skills

Skills eğik çizgi komutlarının nasıl kaydedildiği ve erişimlerinin nasıl denetlendiği.

Skills oluşturma

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

Bu arada

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

Yönlendirme

/steer ile çalışma sırasında agent’ı yönlendirin.