Perintah slash
Perintah ditangani oleh Gateway. Sebagian besar perintah harus dikirim sebagai pesan mandiri yang dimulai dengan/.
Perintah chat bash khusus host menggunakan ! <cmd> (dengan /bash <cmd> sebagai alias).
Ada dua sistem terkait:
- Perintah: pesan
/...mandiri. - Direktif:
/think,/fast,/verbose,/reasoning,/elevated,/exec,/model,/queue.- Direktif dihapus dari pesan sebelum model melihatnya.
- Dalam pesan chat normal (bukan hanya direktif), direktif diperlakukan sebagai “petunjuk inline” dan tidak mempertahankan pengaturan sesi.
- Dalam pesan yang hanya berisi direktif (pesan hanya berisi direktif), direktif dipertahankan ke sesi dan dibalas dengan pengakuan.
- Direktif hanya diterapkan untuk pengirim yang berwenang. Jika
commands.allowFromdisetel, itulah satu-satunya allowlist yang digunakan; jika tidak, otorisasi berasal dari allowlist/pairing channel ditambahcommands.useAccessGroups. Pengirim yang tidak berwenang akan melihat direktif diperlakukan sebagai teks biasa.
/help, /commands, /status, /whoami (/id).
Shortcut ini dijalankan segera, dihapus sebelum model melihat pesan, dan teks yang tersisa melanjutkan ke alur normal.
Konfigurasi
commands.text(defaulttrue) mengaktifkan parsing/...dalam pesan chat.- Pada permukaan tanpa perintah native (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), perintah teks tetap berfungsi meskipun Anda menyetel ini ke
false.
- Pada permukaan tanpa perintah native (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), perintah teks tetap berfungsi meskipun Anda menyetel ini ke
commands.native(default"auto") mendaftarkan perintah native.- Auto: aktif untuk Discord/Telegram; nonaktif untuk Slack (sampai Anda menambahkan slash command); diabaikan untuk penyedia tanpa dukungan native.
- Setel
channels.discord.commands.native,channels.telegram.commands.native, atauchannels.slack.commands.nativeuntuk menimpa per penyedia (bool atau"auto"). falsemenghapus perintah yang sebelumnya terdaftar di Discord/Telegram saat startup. Perintah Slack dikelola di aplikasi Slack dan tidak dihapus secara otomatis.
commands.nativeSkills(default"auto") mendaftarkan perintah skill secara native saat didukung.- Auto: aktif untuk Discord/Telegram; nonaktif untuk Slack (Slack memerlukan pembuatan satu slash command per skill).
- Setel
channels.discord.commands.nativeSkills,channels.telegram.commands.nativeSkills, atauchannels.slack.commands.nativeSkillsuntuk menimpa per penyedia (bool atau"auto").
commands.bash(defaultfalse) mengaktifkan! <cmd>untuk menjalankan perintah shell host (/bash <cmd>adalah alias; memerlukan allowlisttools.elevated).commands.bashForegroundMs(default2000) mengontrol berapa lama bash menunggu sebelum beralih ke mode latar belakang (0langsung ke latar belakang).commands.config(defaultfalse) mengaktifkan/config(membaca/menulisopenclaw.json).commands.mcp(defaultfalse) mengaktifkan/mcp(membaca/menulis konfigurasi MCP yang dikelola OpenClaw di bawahmcp.servers).commands.plugins(defaultfalse) mengaktifkan/plugins(penemuan/status plugin serta kontrol install + aktifkan/nonaktifkan).commands.debug(defaultfalse) mengaktifkan/debug(penimpaan hanya runtime).commands.allowFrom(opsional) menetapkan allowlist per penyedia untuk otorisasi perintah. Saat dikonfigurasi, ini adalah satu-satunya sumber otorisasi untuk perintah dan direktif (allowlist/pairing channel dancommands.useAccessGroupsdiabaikan). Gunakan"*"untuk default global; kunci khusus penyedia menimpanya.commands.useAccessGroups(defaulttrue) menerapkan allowlist/kebijakan untuk perintah saatcommands.allowFromtidak disetel.
Daftar perintah
Teks + native (saat diaktifkan):/help/commands/tools [compact|verbose](tampilkan apa yang dapat digunakan agen saat ini sekarang juga;verbosemenambahkan deskripsi)/skill <name> [input](jalankan skill berdasarkan nama)/status(tampilkan status saat ini; mencakup penggunaan/kuota penyedia untuk penyedia model saat ini jika tersedia)/tasks(daftar tugas latar belakang untuk sesi saat ini; menampilkan detail tugas aktif dan terbaru dengan jumlah fallback lokal agen)/allowlist(daftar/tambah/hapus entri allowlist)/approve <id> <decision>(selesaikan prompt persetujuan exec; gunakan pesan persetujuan tertunda untuk keputusan yang tersedia)/context [list|detail|json](jelaskan “konteks”;detailmenampilkan ukuran per-file + per-tool + per-skill + system prompt)/btw <question>(ajukan pertanyaan sampingan ephemeral tentang sesi saat ini tanpa mengubah konteks sesi di masa mendatang; lihat /tools/btw)/export-session [path](alias:/export) (ekspor sesi saat ini ke HTML dengan system prompt lengkap)/whoami(tampilkan sender id Anda; alias:/id)/session idle <duration|off>(kelola auto-unfocus karena tidak aktif untuk binding thread yang difokuskan)/session max-age <duration|off>(kelola auto-unfocus hard max-age untuk binding thread yang difokuskan)/subagents list|kill|log|info|send|steer|spawn(periksa, kendalikan, atau spawn run sub-agent untuk sesi saat ini)/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions(periksa dan kendalikan sesi runtime ACP)/agents(daftar agen yang terikat ke thread untuk sesi ini)/focus <target>(Discord: ikat thread ini, atau thread baru, ke target sesi/subagent)/unfocus(Discord: hapus binding thread saat ini)/kill <id|#|all>(segera hentikan satu atau semua sub-agent yang sedang berjalan untuk sesi ini; tanpa pesan konfirmasi)/steer <id|#> <message>(arahkan sub-agent yang sedang berjalan segera: di tengah run bila memungkinkan, jika tidak hentikan pekerjaan saat ini dan mulai ulang dengan pesan pengarah)/tell <id|#> <message>(alias untuk/steer)/config show|get|set|unset(pertahankan konfigurasi ke disk, hanya owner; memerlukancommands.config: true)/mcp show|get|set|unset(kelola konfigurasi server MCP OpenClaw, hanya owner; memerlukancommands.mcp: true)/plugins list|show|get|install|enable|disable(periksa plugin yang ditemukan, instal plugin baru, dan ubah status aktif; hanya owner untuk penulisan; memerlukancommands.plugins: true)/pluginadalah alias untuk/plugins./plugin install <spec>menerima spesifikasi plugin yang sama sepertiopenclaw plugins install: path/archive lokal, paket npm, atauclawhub:<pkg>.- Penulisan aktifkan/nonaktifkan tetap membalas dengan petunjuk restart. Pada gateway foreground yang dipantau, OpenClaw dapat melakukan restart itu secara otomatis tepat setelah penulisan.
/debug show|set|unset|reset(penimpaan runtime, hanya owner; memerlukancommands.debug: true)/usage off|tokens|full|cost(footer penggunaan per respons atau ringkasan biaya lokal)/tts off|always|inbound|tagged|status|provider|limit|summary|audio(kendalikan TTS; lihat /tts)- Discord: perintah native adalah
/voice(Discord mencadangkan/tts); teks/ttstetap berfungsi.
- Discord: perintah native adalah
/stop/restart/dock-telegram(alias:/dock_telegram) (alihkan balasan ke Telegram)/dock-discord(alias:/dock_discord) (alihkan balasan ke Discord)/dock-slack(alias:/dock_slack) (alihkan balasan ke Slack)/activation mention|always(khusus grup)/send on|off|inherit(hanya owner)/resetatau/new [model](petunjuk model opsional; sisanya diteruskan)/think <off|minimal|low|medium|high|xhigh>(pilihan dinamis menurut model/penyedia; alias:/thinking,/t)/fast status|on|off(tanpa argumen menampilkan status mode cepat efektif saat ini)/verbose on|full|off(alias:/v)/reasoning on|off|stream(alias:/reason; saat aktif, mengirim pesan terpisah berawalanReasoning:;stream= draft Telegram saja)/elevated on|off|ask|full(alias:/elev;fullmelewati persetujuan exec)/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>(kirim/execuntuk menampilkan status saat ini)/model <name>(alias:/models; atau/<alias>dariagents.defaults.models.*.alias)/queue <mode>(ditambah opsi sepertidebounce:2s cap:25 drop:summarize; kirim/queueuntuk melihat pengaturan saat ini)/bash <command>(khusus host; alias untuk! <command>; memerlukancommands.bash: true+ allowlisttools.elevated)/dreaming [off|core|rem|deep|status|help](ubah mode dreaming atau tampilkan status; lihat Dreaming)
/compact [instructions](lihat /concepts/compaction)! <command>(khusus host; satu per satu; gunakan!poll+!stopuntuk pekerjaan yang berjalan lama)!poll(periksa output / status; menerimasessionIdopsional;/bash polljuga berfungsi)!stop(hentikan pekerjaan bash yang sedang berjalan; menerimasessionIdopsional;/bash stopjuga berfungsi)
- Perintah menerima
:opsional antara perintah dan argumen (misalnya/think: high,/send: on,/help:). /new <model>menerima alias model,provider/model, atau nama penyedia (pencocokan fuzzy); jika tidak ada yang cocok, teks diperlakukan sebagai isi pesan.- Untuk rincian lengkap penggunaan per penyedia, gunakan
openclaw status --usage. /allowlist add|removememerlukancommands.config=truedan menghormaticonfigWriteschannel.- Di channel multi-akun,
/allowlist --account <id>yang menargetkan konfigurasi dan/config set channels.<provider>.accounts.<id>...juga menghormaticonfigWritesakun target. /usagemengontrol footer penggunaan per respons;/usage costmencetak ringkasan biaya lokal dari log sesi OpenClaw./restartaktif secara default; setelcommands.restart: falseuntuk menonaktifkannya.- Perintah native khusus Discord:
/vc join|leave|statusmengontrol channel suara (memerlukanchannels.discord.voicedan perintah native; tidak tersedia sebagai teks). - Perintah binding thread Discord (
/focus,/unfocus,/agents,/session idle,/session max-age) memerlukan binding thread efektif diaktifkan (session.threadBindings.enableddan/atauchannels.discord.threadBindings.enabled). - Referensi perintah ACP dan perilaku runtime: ACP Agents.
/verbosedimaksudkan untuk debugging dan visibilitas tambahan; biarkan nonaktif dalam penggunaan normal./fast on|offmempertahankan penimpaan sesi. Gunakan opsiinheritdi UI Sessions untuk menghapusnya dan kembali ke default konfigurasi./fastbersifat khusus penyedia: OpenAI/OpenAI Codex memetakannya keservice_tier=prioritypada endpoint Responses native, sedangkan permintaan Anthropic publik langsung, termasuk traffic terautentikasi OAuth yang dikirim keapi.anthropic.com, memetakannya keservice_tier=autoataustandard_only. Lihat OpenAI dan Anthropic.- Ringkasan kegagalan tool tetap ditampilkan saat relevan, tetapi teks kegagalan terperinci hanya disertakan ketika
/verbosebernilaionataufull. /reasoning(dan/verbose) berisiko dalam pengaturan grup: keduanya dapat mengungkap reasoning internal atau output tool yang tidak ingin Anda tampilkan. Sebaiknya biarkan nonaktif, terutama di chat grup./modellangsung mempertahankan model sesi baru.- Jika agen sedang idle, run berikutnya langsung menggunakannya.
- Jika run sudah aktif, OpenClaw menandai live switch sebagai tertunda dan hanya restart ke model baru pada titik retry yang bersih.
- Jika aktivitas tool atau output balasan sudah dimulai, perpindahan tertunda dapat tetap antre hingga peluang retry berikutnya atau giliran pengguna berikutnya.
- Jalur cepat: pesan yang hanya berisi perintah dari pengirim yang di-allowlist ditangani segera (melewati antrean + model).
- Penyaringan mention grup: pesan yang hanya berisi perintah dari pengirim yang di-allowlist melewati persyaratan mention.
- Shortcut inline (hanya pengirim yang di-allowlist): perintah tertentu juga berfungsi saat disematkan dalam pesan normal dan dihapus sebelum model melihat teks yang tersisa.
- Contoh:
hey /statusmemicu balasan status, dan teks yang tersisa melanjutkan ke alur normal.
- Contoh:
- Saat ini:
/help,/commands,/status,/whoami(/id). - Pesan yang hanya berisi perintah dari pihak tak berwenang diabaikan diam-diam, dan token inline
/...diperlakukan sebagai teks biasa. - Perintah skill: skill
user-invocablediekspos sebagai perintah slash. Nama dibersihkan menjadia-z0-9_(maks. 32 karakter); benturan diberi sufiks numerik (misalnya_2)./skill <name> [input]menjalankan skill berdasarkan nama (berguna ketika batas perintah native mencegah perintah per-skill).- Secara default, perintah skill diteruskan ke model sebagai permintaan normal.
- Skill secara opsional dapat mendeklarasikan
command-dispatch: tooluntuk merutekan perintah langsung ke tool (deterministik, tanpa model). - Contoh:
/prose(plugin OpenProse) — lihat OpenProse.
- Argumen perintah native: Discord menggunakan autocomplete untuk opsi dinamis (dan menu tombol saat Anda menghilangkan argumen wajib). Telegram dan Slack menampilkan menu tombol saat suatu perintah mendukung pilihan dan Anda menghilangkan argumennya.
/tools
/tools menjawab pertanyaan runtime, bukan pertanyaan konfigurasi: apa yang dapat digunakan agen ini sekarang juga dalam
percakapan ini.
- Default
/toolsbersifat ringkas dan dioptimalkan untuk pemindaian cepat. /tools verbosemenambahkan deskripsi singkat.- Permukaan perintah native yang mendukung argumen mengekspos pengalih mode yang sama seperti
compact|verbose. - Hasil bersifat per sesi, jadi mengubah agen, channel, thread, otorisasi pengirim, atau model dapat mengubah output.
/toolsmencakup tool yang benar-benar dapat dijangkau saat runtime, termasuk tool inti, tool plugin yang terhubung, dan tool milik channel.
/tools sebagai katalog statis.
Permukaan penggunaan (apa yang muncul di mana)
- Penggunaan/kuota penyedia (contoh: “Claude tersisa 80%”) muncul di
/statusuntuk penyedia model saat ini ketika pelacakan penggunaan diaktifkan. OpenClaw menormalkan jendela penyedia menjadi% tersisa; untuk MiniMax, bidang persentase khusus sisa dibalik sebelum ditampilkan, dan responsmodel_remainsmengutamakan entri model chat plus label paket bertag model. - Baris token/cache di
/statusdapat fallback ke entri penggunaan transkrip terbaru ketika snapshot sesi live jarang. Nilai live nonzero yang sudah ada tetap menang, dan fallback transkrip juga dapat memulihkan label model runtime aktif plus total berorientasi prompt yang lebih besar saat total yang tersimpan tidak ada atau lebih kecil. - Token/biaya per respons dikontrol oleh
/usage off|tokens|full(ditambahkan ke balasan normal). /model statusberkaitan dengan model/auth/endpoint, bukan penggunaan.
Pemilihan model (/model)
/model diimplementasikan sebagai direktif.
Contoh:
/modeldan/model listmenampilkan pemilih ringkas bernomor (keluarga model + penyedia yang tersedia).- Di Discord,
/modeldan/modelsmembuka pemilih interaktif dengan dropdown penyedia dan model plus langkah Submit. /model <#>memilih dari pemilih tersebut (dan mengutamakan penyedia saat ini bila memungkinkan)./model statusmenampilkan tampilan terperinci, termasuk endpoint penyedia yang dikonfigurasi (baseUrl) dan mode API (api) jika tersedia.
Penimpaan debug
/debug memungkinkan Anda menyetel penimpaan konfigurasi hanya runtime (memori, bukan disk). Hanya owner. Nonaktif secara default; aktifkan dengan commands.debug: true.
Contoh:
- Penimpaan langsung berlaku untuk pembacaan konfigurasi baru, tetapi tidak menulis ke
openclaw.json. - Gunakan
/debug resetuntuk menghapus semua penimpaan dan kembali ke konfigurasi di disk.
Pembaruan konfigurasi
/config menulis ke konfigurasi di disk Anda (openclaw.json). Hanya owner. Nonaktif secara default; aktifkan dengan commands.config: true.
Contoh:
- Konfigurasi divalidasi sebelum penulisan; perubahan yang tidak valid ditolak.
- Pembaruan
/configdipertahankan saat restart.
Pembaruan MCP
/mcp menulis definisi server MCP yang dikelola OpenClaw di bawah mcp.servers. Hanya owner. Nonaktif secara default; aktifkan dengan commands.mcp: true.
Contoh:
/mcpmenyimpan konfigurasi di konfigurasi OpenClaw, bukan pengaturan proyek milik Pi.- Adaptor runtime menentukan transport mana yang benar-benar dapat dijalankan.
Pembaruan plugin
/plugins memungkinkan operator memeriksa plugin yang ditemukan dan mengubah status aktif di konfigurasi. Alur baca-saja dapat menggunakan /plugin sebagai alias. Nonaktif secara default; aktifkan dengan commands.plugins: true.
Contoh:
/plugins listdan/plugins showmenggunakan penemuan plugin nyata terhadap workspace saat ini plus konfigurasi di disk./plugins enable|disablehanya memperbarui konfigurasi plugin; tidak menginstal atau menghapus instalasi plugin.- Setelah perubahan aktifkan/nonaktifkan, restart gateway untuk menerapkannya.
Catatan permukaan
- Perintah teks berjalan di sesi chat normal (DM berbagi
main, grup memiliki sesinya sendiri). - Perintah native menggunakan sesi terisolasi:
- Discord:
agent:<agentId>:discord:slash:<userId> - Slack:
agent:<agentId>:slack:slash:<userId>(prefiks dapat dikonfigurasi melaluichannels.slack.slashCommand.sessionPrefix) - Telegram:
telegram:slash:<userId>(menargetkan sesi chat melaluiCommandTargetSessionKey)
- Discord:
/stopmenargetkan sesi chat aktif sehingga dapat membatalkan run saat ini.- Slack:
channels.slack.slashCommandmasih didukung untuk satu perintah bergaya/openclaw. Jika Anda mengaktifkancommands.native, Anda harus membuat satu Slack slash command per perintah bawaan (nama yang sama dengan/help). Menu argumen perintah untuk Slack dikirim sebagai tombol Block Kit ephemeral.- Pengecualian native Slack: daftarkan
/agentstatus(bukan/status) karena Slack mencadangkan/status. Teks/statustetap berfungsi dalam pesan Slack.
- Pengecualian native Slack: daftarkan
Pertanyaan sampingan BTW
/btw adalah pertanyaan sampingan cepat tentang sesi saat ini.
Berbeda dari chat normal:
- ini menggunakan sesi saat ini sebagai konteks latar belakang,
- ini berjalan sebagai panggilan satu kali tanpa tool yang terpisah,
- ini tidak mengubah konteks sesi di masa mendatang,
- ini tidak ditulis ke riwayat transkrip,
- ini dikirim sebagai hasil sampingan live alih-alih pesan asisten normal.
/btw berguna saat Anda menginginkan klarifikasi sementara sementara tugas
utama tetap berjalan.
Contoh: