/.
Perintah bash khusus host menggunakan ! <cmd> (dengan /bash <cmd> sebagai alias).
Saat percakapan terikat ke sesi ACP, teks biasa diarahkan ke harness ACP.
Perintah pengelolaan Gateway tetap lokal: /acp ... selalu diteruskan ke
penangan perintah OpenClaw, dan /status serta /unfocus tetap lokal setiap kali
penanganan perintah diaktifkan untuk permukaan tersebut.
Tiga jenis perintah
Perintah
Pesan
/... mandiri yang ditangani oleh Gateway. Harus dikirim sebagai
satu-satunya konten dalam pesan.Direktif
/think, /fast, /verbose, /trace, /reasoning, /elevated,
/exec, /model, /queue — dihapus dari pesan sebelum dilihat
oleh model. Mempertahankan pengaturan sesi saat dikirim sendiri; bertindak sebagai
petunjuk sebaris saat dikirim bersama teks lain.Pintasan sebaris
/help, /commands, /status, /whoami — langsung dijalankan dan
dihapus sebelum model melihat teks yang tersisa. Hanya pengirim yang berwenang.Detail perilaku direktif
Detail perilaku direktif
- Direktif dihapus dari pesan sebelum dilihat oleh model.
- Dalam pesan khusus direktif (pesan hanya berisi direktif), direktif dipertahankan dalam sesi dan dibalas dengan konfirmasi.
- Dalam pesan percakapan biasa yang berisi teks lain, direktif bertindak sebagai petunjuk sebaris dan tidak mempertahankan pengaturan sesi.
- Direktif hanya berlaku untuk pengirim yang berwenang. Jika
commands.allowFromditetapkan, itulah satu-satunya daftar izin yang digunakan; jika tidak, otorisasi berasal dari daftar izin/penyandingan saluran sertacommands.useAccessGroups. Pengirim yang tidak berwenang akan melihat direktif diperlakukan sebagai teks biasa.
Konfigurasi
boolean
default:"true"
Mengaktifkan penguraian
/... dalam pesan percakapan. Pada permukaan tanpa perintah native
(WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), perintah teks
tetap berfungsi meskipun ditetapkan ke false.boolean | "auto"
default:"\"auto\""
Mendaftarkan perintah native. Otomatis: aktif untuk Discord/Telegram; nonaktif untuk Slack;
diabaikan untuk penyedia tanpa dukungan native. Timpa per saluran dengan
channels.<provider>.commands.native. Di Discord, false melewati pendaftaran
perintah garis miring; perintah yang sebelumnya didaftarkan mungkin tetap terlihat hingga dihapus.boolean | "auto"
default:"\"auto\""
Mendaftarkan perintah skill secara native jika didukung. Otomatis: aktif untuk
Discord/Telegram; nonaktif untuk Slack. Timpa dengan
channels.<provider>.commands.nativeSkills.boolean
default:"false"
Mengaktifkan
! <cmd> untuk menjalankan perintah shell host (alias /bash <cmd>). Memerlukan
daftar izin tools.elevated.number
default:"2000"
Durasi tunggu bash sebelum beralih ke mode latar belakang (
0 langsung
menjalankannya di latar belakang).boolean
default:"false"
Mengaktifkan
/config (membaca/menulis openclaw.json). Khusus pemilik.boolean
default:"false"
Mengaktifkan
/mcp (membaca/menulis konfigurasi MCP yang dikelola OpenClaw di bawah mcp.servers). Khusus pemilik.boolean
default:"false"
Mengaktifkan
/plugins (penemuan/status plugin serta pemasangan + pengaktifan/penonaktifan). Penulisan khusus pemilik.boolean
default:"false"
Mengaktifkan
/debug (penimpaan konfigurasi khusus runtime). Khusus pemilik.boolean
default:"true"
Mengaktifkan
/restart dan permintaan mulai ulang eksternal SIGUSR1.string[]
Daftar izin pemilik eksplisit untuk permukaan perintah khusus pemilik. Terpisah dari
commands.allowFrom dan akses penyandingan DM.boolean
default:"false"
Per saluran: mewajibkan identitas pemilik untuk perintah khusus pemilik. Saat
true,
pengirim harus cocok dengan commands.ownerAllowFrom atau memiliki cakupan internal operator.admin.
Entri karakter pengganti allowFrom tidak memadai."raw" | "hash"
Mengontrol cara id pemilik ditampilkan dalam prompt sistem.
string
Rahasia HMAC yang digunakan saat
commands.ownerDisplay: "hash".object
Daftar izin per penyedia untuk otorisasi perintah. Saat dikonfigurasi, daftar ini menjadi
satu-satunya sumber otorisasi untuk perintah dan direktif. Gunakan
"*" sebagai
default global; kunci khusus penyedia menimpanya.boolean
default:"true"
Menerapkan daftar izin/kebijakan untuk perintah saat
commands.allowFrom tidak ditetapkan.Daftar perintah
Perintah berasal dari tiga sumber:- Bawaan inti:
src/auto-reply/commands-registry.shared.ts - Perintah dock yang dihasilkan:
src/auto-reply/commands-registry.data.ts - Perintah plugin: pemanggilan
registerCommand()oleh plugin
Perintah inti
Sesi dan proses
Sesi dan proses
Jalur
/export-session yang eksplisit mengganti file yang sudah ada di dalam
ruang kerja. Hilangkan jalur untuk menghasilkan nama file yang aman dari benturan.Control UI mencegat
/new yang diketik untuk membuat dan beralih ke sesi
dasbor baru, kecuali jika session.dmScope: "main" dikonfigurasi
dan induk saat ini adalah sesi utama agen — dalam hal tersebut /new
mengatur ulang sesi utama di tempat. /reset yang diketik tetap menjalankan
pengaturan ulang di tempat milik Gateway. Gunakan /model default jika Anda ingin menghapus
pilihan model sesi yang disematkan.Kontrol model dan proses
Kontrol model dan proses
Keamanan verbose / pelacakan / cepat / penalaran
Keamanan verbose / pelacakan / cepat / penalaran
/verboseditujukan untuk debugging — biarkan nonaktif dalam penggunaan normal./tracehanya menampilkan baris pelacakan/debug milik plugin; percakapan verbose biasa tetap nonaktif./fast auto|on|offmempertahankan penimpaan sesi; gunakan opsiinheritdi UI Sesi untuk menghapusnya./fastbersifat khusus penyedia: OpenAI/Codex memetakannya keservice_tier=priority; permintaan langsung Anthropic memetakannya keservice_tier=autoataustandard_only./reasoning,/verbose, dan/traceberisiko dalam pengaturan grup — fitur tersebut dapat mengungkap penalaran internal atau diagnostik plugin. Biarkan nonaktif dalam percakapan grup.
Detail pergantian model
Detail pergantian model
/modellangsung mempertahankan model baru dalam sesi.- Jika agen sedang tidak aktif, proses berikutnya langsung menggunakannya.
- Jika proses sedang aktif, pergantian ditandai sebagai tertunda dan diterapkan pada titik percobaan ulang bersih berikutnya.
Penemuan dan status
Penemuan dan status
Skills, daftar izin, persetujuan
Skills, daftar izin, persetujuan
Subagen dan ACP
Subagen dan ACP
Penulisan dan administrasi khusus pemilik
Penulisan dan administrasi khusus pemilik
Suara, TTS, kontrol kanal
Suara, TTS, kontrol kanal
Perintah docking
Perintah docking mengalihkan rute balasan sesi aktif ke kanal tertaut lainnya. Lihat Docking kanal untuk penyiapan dan pemecahan masalah. Dihasilkan dari plugin kanal dengan dukungan perintah native:/dock-discord(alias:/dock_discord)/dock-mattermost(alias:/dock_mattermost)/dock-slack(alias:/dock_slack)/dock-telegram(alias:/dock_telegram)
session.identityLinks. Pengirim sumber dan peer target
harus berada dalam grup identitas yang sama.
Perintah plugin bawaan
Khusus QQBot:
/bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs
Perintah skill
Skill yang dapat dijalankan pengguna diekspos sebagai perintah garis miring:/skill <name> [input]selalu berfungsi sebagai titik masuk generik.- Skills dapat didaftarkan sebagai perintah langsung (misalnya
/proseuntuk OpenProse). - Pendaftaran perintah skill native dikontrol oleh
commands.nativeSkillsdanchannels.<provider>.commands.nativeSkills. - Nama dibersihkan menjadi
a-z0-9_(maks. 32 karakter); konflik mendapatkan akhiran numerik.
Pengiriman perintah skill
Pengiriman perintah skill
Secara bawaan, perintah skill dirutekan ke model sebagai permintaan normal.Skills dapat mendeklarasikan
command-dispatch: tool untuk merutekan langsung ke alat
(deterministik, tanpa keterlibatan model). Contoh: /prose (plugin OpenProse)
— lihat OpenProse.Argumen perintah native
Argumen perintah native
Discord menggunakan pelengkapan otomatis untuk opsi dinamis dan menu tombol ketika argumen
yang diperlukan tidak diberikan. Telegram dan Slack menampilkan menu tombol untuk perintah dengan
pilihan. Pilihan dinamis ditentukan berdasarkan model sesi target, sehingga opsi khusus
model seperti tingkat
/think mengikuti penggantian /model sesi./tools: yang dapat digunakan agen sekarang
/tools menjawab pertanyaan runtime: apa yang dapat digunakan agen ini saat ini dalam
percakapan ini — bukan katalog konfigurasi statis.
/model: pemilihan model
/model dan /models membuka pemilih interaktif dengan menu tarik-turun penyedia dan
model. Pemilih mematuhi agents.defaults.modelPolicy.allow,
termasuk entri provider/*. Tanpa daftar izin eksplisit, entri model dan
alias tidak membatasi pemilihan.
/config: penulisan konfigurasi pada disk
Khusus pemilik. Dinonaktifkan secara bawaan — aktifkan dengan
commands.config: true./config
tetap ada setelah dimulai ulang.
/mcp: konfigurasi server MCP
Khusus pemilik. Dinonaktifkan secara bawaan — aktifkan dengan
commands.mcp: true./mcp menyimpan konfigurasi dalam konfigurasi OpenClaw, bukan dalam pengaturan proyek agen tertanam.
/mcp show menyamarkan bidang yang memuat kredensial, nilai flag kredensial
yang dikenali, dan argumen yang diketahui menyerupai rahasia. Ketika dijalankan dari grup,
konfigurasi dikirim secara pribadi kepada pemilik; jika tidak tersedia rute pribadi ke
pemilik, perintah gagal secara tertutup dan meminta pemilik mencoba lagi dari percakapan
langsung.
/debug: penggantian khusus runtime
Khusus pemilik. Dinonaktifkan secara bawaan — aktifkan dengan
commands.debug: true.
Penggantian langsung diterapkan pada pembacaan konfigurasi baru, tetapi tidak ditulis ke disk./plugins: pengelolaan plugin
Penulisan hanya untuk pemilik. Dinonaktifkan secara bawaan — aktifkan dengan
commands.plugins: true./plugins enable|disable memperbarui konfigurasi plugin dan memuat ulang secara langsung runtime
plugin Gateway untuk giliran agen baru. /plugins install memulai ulang Gateway yang
dikelola secara otomatis karena modul sumber plugin berubah. Instalasi ClawHub tepercaya
dan katalog resmi tidak memerlukan pengakuan tambahan. Sumber npm, git, arsip,
npm-pack:, dan jalur lokal arbitrer menampilkan peringatan asal-usul dan
memerlukan --force di bagian akhir setelah Anda meninjau sumbernya. Flag ini mengakui
sumber dan mengizinkan penggantian instalasi yang sudah ada; flag ini tidak melewati
security.installPolicy atau pemeriksaan keamanan penginstal. Rilis ClawHub dengan
peringatan risiko tetap memerlukan flag khusus shell yang terpisah,
--acknowledge-clawhub-risk. Instalasi marketplace, tertaut, dan disematkan juga
tetap hanya tersedia melalui shell.
/trace: keluaran pelacakan plugin
/trace menampilkan baris pelacakan/debug plugin dengan cakupan sesi tanpa mode verbose
penuh. Ini tidak menggantikan /debug (penggantian runtime) atau /verbose (keluaran
alat normal).
/btw: pertanyaan sampingan
/btw adalah pertanyaan sampingan cepat tentang konteks sesi saat ini. Alias: /side.
- Menggunakan sesi saat ini sebagai konteks latar belakang.
- Dalam sesi harness Codex, berjalan sebagai utas sampingan Codex sementara.
- Tidak mengubah konteks sesi mendatang.
- Tidak ditulis ke riwayat transkrip.
Catatan permukaan
Cakupan sesi per permukaan
Cakupan sesi per permukaan
- Perintah teks: berjalan dalam sesi percakapan normal (DM berbagi
main, grup memiliki sesinya sendiri). - Perintah native Discord:
agent:<agentId>:discord:slash:<userId> - Perintah native Slack:
agent:<agentId>:slack:slash:<userId>(awalan dapat dikonfigurasi melaluichannels.slack.slashCommand.sessionPrefix) - Perintah native Telegram:
telegram:slash:<userId>(menargetkan sesi percakapan melaluiCommandTargetSessionKey) /login codexmengirim kode pemasangan perangkat hanya melalui percakapan pribadi atau jalur respons UI Web. Pemanggilan dari grup/topik Telegram meminta pemilik mengirim DM ke bot sebagai gantinya./stopmenargetkan sesi percakapan aktif untuk membatalkan proses saat ini.
Khusus Slack
Khusus Slack
channels.slack.slashCommand mendukung satu perintah bergaya /openclaw.
Dengan commands.native: true, buat satu perintah garis miring Slack untuk setiap
perintah bawaan. Daftarkan /agentstatus (bukan /status) karena Slack mencadangkan
/status. Teks /status tetap berfungsi dalam pesan Slack.Jalur cepat dan pintasan sebaris
Jalur cepat dan pintasan sebaris
- Pesan yang hanya berisi perintah dari pengirim dalam daftar yang diizinkan ditangani segera (melewati antrean + model).
- Pintasan sebaris (
/help,/commands,/status,/whoami) juga berfungsi saat disematkan dalam pesan biasa dan dihapus sebelum model melihat teks yang tersisa. - Pesan tidak sah yang hanya berisi perintah diabaikan tanpa pemberitahuan; token
/...sebaris diperlakukan sebagai teks biasa.
Catatan argumen
Catatan argumen
- Perintah menerima
:opsional di antara perintah dan argumen (/think: high,/send: on). /new <model>menerima alias model,provider/model, atau nama penyedia (pencocokan fuzzy); jika tidak ada kecocokan, teks tersebut diperlakukan sebagai isi pesan./allowlist add|removememerlukancommands.config: truedan mematuhiconfigWriteskanal.
Penggunaan dan status penyedia
- Penggunaan/kuota penyedia (misalnya, “Claude tersisa 80%”) ditampilkan di
/statusuntuk penyedia model saat ini ketika pelacakan penggunaan diaktifkan. - Baris token/cache di
/statusdapat menggunakan entri penggunaan transkrip terbaru sebagai cadangan ketika snapshot sesi langsung minim. - Eksekusi vs runtime:
/statusmelaporkanExecutionuntuk jalur sandbox yang efektif danRuntimeuntuk pihak yang menjalankan sesi:OpenClaw Default,OpenAI Codex, backend CLI, atau backend ACP. - Token/biaya per respons: dikontrol oleh
/usage off|tokens|full. /model statusberkaitan dengan model/autentikasi/endpoint, bukan penggunaan.
Terkait
Skills
Cara perintah garis miring Skills didaftarkan dan dibatasi.
Membuat Skills
Buat skill yang mendaftarkan perintah garis miringnya sendiri.
BTW
Pertanyaan sampingan tanpa mengubah konteks sesi.
Arahkan
Arahkan agen di tengah proses dengan
/steer.