Skills
Perintah garis miring
Gateway menangani perintah yang dikirim sebagai pesan mandiri yang diawali dengan /.
Perintah bash khusus host menggunakan ! <cmd> (dengan /bash <cmd> sebagai alias).
Saat percakapan terikat ke sesi ACP, teks biasa dirutekan ke harness ACP.
Perintah pengelolaan Gateway tetap lokal: /acp ... selalu diteruskan ke
penangan perintah OpenClaw, sedangkan /status dan /unfocus tetap lokal setiap kali
penanganan perintah diaktifkan untuk permukaan tersebut.
Tiga jenis perintah
Pesan mandiri /... yang ditangani oleh Gateway. Harus dikirim sebagai
satu-satunya konten dalam pesan.
/think, /fast, /verbose, /trace, /reasoning, /elevated,
/exec, /model, /queue — dihapus dari pesan sebelum model
melihatnya. Mempertahankan pengaturan sesi saat dikirim sendiri; bertindak sebagai petunjuk sebaris
saat dikirim bersama teks lain.
/help, /commands, /status, /whoami — dijalankan segera dan
dihapus sebelum model melihat teks yang tersisa. Hanya pengirim yang diotorisasi.
Detail perilaku direktif
- Direktif dihapus dari pesan sebelum model melihatnya.
- Dalam pesan khusus direktif (pesan hanya berisi direktif), direktif dipertahankan dalam sesi dan dibalas dengan konfirmasi.
- Dalam pesan obrolan normal yang berisi teks lain, direktif bertindak sebagai petunjuk sebaris dan tidak mempertahankan pengaturan sesi.
- Direktif hanya berlaku bagi pengirim yang diotorisasi. Jika
commands.allowFromditetapkan, hanya daftar izin tersebut yang digunakan; jika tidak, otorisasi berasal dari daftar izin kanal/pemasangan sertacommands.useAccessGroups. Pengirim yang tidak diotorisasi akan melihat direktif diperlakukan sebagai teks biasa.
Konfigurasi
{ 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.textbooleandefault: trueMengaktifkan penguraian /... dalam pesan obrolan. Pada permukaan tanpa perintah native
(WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), perintah teks
tetap berfungsi meskipun ditetapkan ke false.
commands.nativeboolean | "auto"default: "auto"Mendaftarkan perintah native. Otomatis: aktif untuk Discord/Telegram; nonaktif untuk Slack;
diabaikan untuk penyedia tanpa dukungan native. Timpa per kanal dengan
channels.<provider>.commands.native. Di Discord, false melewati pendaftaran
perintah garis miring; perintah yang sebelumnya didaftarkan mungkin tetap terlihat hingga dihapus.
commands.nativeSkillsboolean | "auto"default: "auto"Mendaftarkan perintah Skills secara native jika didukung. Otomatis: aktif untuk
Discord/Telegram; nonaktif untuk Slack. Timpa dengan
channels.<provider>.commands.nativeSkills.
commands.bashbooleandefault: falseMengaktifkan ! <cmd> untuk menjalankan perintah shell host (alias /bash <cmd>). Memerlukan
daftar izin tools.elevated.
commands.bashForegroundMsnumberdefault: 2000Durasi bash menunggu sebelum beralih ke mode latar belakang (0 langsung berjalan
di latar belakang).
commands.configbooleandefault: falseMengaktifkan /config (membaca/menulis openclaw.json). Khusus pemilik.
commands.mcpbooleandefault: falseMengaktifkan /mcp (membaca/menulis konfigurasi MCP yang dikelola OpenClaw di bawah mcp.servers). Khusus pemilik.
commands.pluginsbooleandefault: falseMengaktifkan /plugins (penemuan/status plugin serta pemasangan + pengaktifan/penonaktifan). Penulisan hanya untuk pemilik.
commands.debugbooleandefault: falseMengaktifkan /debug (penimpaan konfigurasi khusus waktu proses). Khusus pemilik.
commands.restartbooleandefault: trueMengaktifkan /restart dan tindakan alat untuk memulai ulang Gateway.
commands.ownerAllowFromstring[]Daftar izin pemilik eksplisit untuk permukaan perintah khusus pemilik. Terpisah dari
commands.allowFrom dan akses pemasangan DM.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
Per kanal: mewajibkan identitas pemilik untuk perintah khusus pemilik. Saat true,
pengirim harus cocok dengan commands.ownerAllowFrom atau memiliki cakupan internal operator.admin.
Entri wildcard allowFrom tidak memadai.
commands.ownerDisplay"raw" | "hash"Mengontrol bagaimana ID pemilik ditampilkan dalam prompt sistem.
commands.ownerDisplaySecretstringRahasia HMAC yang digunakan saat commands.ownerDisplay: "hash".
commands.allowFromobjectDaftar izin per penyedia untuk otorisasi perintah. Jika dikonfigurasi, ini menjadi
satu-satunya sumber otorisasi untuk perintah dan direktif. Gunakan "*" sebagai
default global; kunci khusus penyedia akan menimpanya.
commands.useAccessGroupsbooleandefault: trueMenerapkan 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
Ketersediaan bergantung pada flag konfigurasi, permukaan kanal, serta plugin yang terpasang/diaktifkan.
Perintah inti
Sesi dan proses
| Perintah | Deskripsi |
|---|---|
/new [model] |
Arsipkan sesi saat ini dan mulai sesi baru |
/reset [soft [message]] |
Atur ulang sesi saat ini tanpa menggantinya. soft mempertahankan transkrip, menghapus id sesi backend CLI yang digunakan kembali, dan menjalankan ulang proses awal |
/name <title> |
Beri nama atau ubah nama sesi saat ini. Hilangkan judul untuk melihat nama saat ini dan saran |
/compact [instructions] |
Padatkan konteks sesi. Lihat Compaction |
/stop |
Batalkan proses saat ini |
/session idle <duration|off> |
Kelola kedaluwarsa akibat tidak aktif untuk pengikatan utas |
/session max-age <duration|off> |
Kelola kedaluwarsa usia maksimum untuk pengikatan utas |
/export-session [path] |
Ekspor sesi saat ini ke HTML. Alias: /export |
/export-trajectory [path] |
Ekspor bundel lintasan JSONL untuk sesi saat ini. Alias: /trajectory |
Kontrol model dan proses
| Perintah | Deskripsi |
|---|---|
/think <level|default> |
Tetapkan tingkat pemikiran atau hapus penggantian sesi. Alias: /thinking, /t |
/verbose on|off|full |
Aktifkan atau nonaktifkan keluaran terperinci. Alias: /v |
/trace on|off |
Aktifkan atau nonaktifkan keluaran pelacakan plugin untuk sesi saat ini |
/fast [status|auto|on|off|default] |
Tampilkan, tetapkan, atau hapus mode cepat |
/reasoning [on|off|stream] |
Aktifkan atau nonaktifkan visibilitas penalaran. Alias: /reason |
/elevated [on|off|ask|full] |
Aktifkan atau nonaktifkan mode dengan hak akses tinggi. Alias: /elev |
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> |
Tampilkan atau tetapkan nilai bawaan eksekusi |
/login [codex|openai|openai-codex] |
Pasangkan proses masuk Codex/OpenAI dari obrolan privat atau sesi Web UI. Hanya pemilik/admin |
/model [name|#|status] |
Tampilkan atau tetapkan model |
/models [provider] [page] [limit=<n>|all] |
Cantumkan penyedia atau model yang dikonfigurasi/tersedia melalui autentikasi |
/queue <mode> |
Kelola perilaku antrean proses aktif. Lihat Antrean dan Pengarahan antrean |
/steer <message> |
Masukkan panduan ke dalam proses aktif. Alias: /tell. Lihat Pengarahan |
keamanan verbose / trace / fast / reasoning
/verbosedigunakan untuk proses debug — biarkan nonaktif dalam penggunaan normal./tracehanya menampilkan baris pelacakan/debug milik plugin; keluaran terperinci biasa tetap nonaktif./fast auto|on|offmempertahankan penggantian sesi; gunakan opsiinheritdi UI Sesi untuk menghapusnya./fastbergantung pada penyedia: OpenAI/Codex memetakannya keservice_tier=priority; permintaan langsung Anthropic memetakannya keservice_tier=autoataustandard_only./reasoning,/verbose, dan/traceberisiko dalam lingkungan grup — semuanya dapat mengungkapkan penalaran internal atau diagnostik plugin. Biarkan semuanya nonaktif dalam obrolan grup.
Detail pergantian model
/modelsegera menyimpan model baru ke sesi.- Jika agen sedang menganggur, eksekusi berikutnya langsung menggunakannya.
- Jika eksekusi sedang aktif, pergantian ditandai sebagai tertunda dan diterapkan pada titik percobaan ulang bersih berikutnya.
Penemuan dan status
| Perintah | Deskripsi |
|---|---|
/help |
Tampilkan ringkasan bantuan singkat |
/commands |
Tampilkan katalog perintah yang dihasilkan |
/tools [compact|verbose] |
Tampilkan hal yang dapat digunakan agen saat ini |
/status |
Tampilkan status eksekusi/runtime, waktu aktif Gateway dan sistem, kesehatan plugin, serta penggunaan/kuota penyedia |
/status plugins |
Tampilkan detail kesehatan plugin: kesalahan pemuatan, karantina, kegagalan plugin kanal, masalah dependensi, pemberitahuan kompatibilitas. Memerlukan commands.plugins: true |
/goal [status|start|edit|pause|resume|complete|block|clear] ... |
Kelola sasaran persisten sesi saat ini |
/diagnostics [note] |
Alur laporan dukungan khusus pemilik. Selalu meminta persetujuan eksekusi |
/crestodian <request> |
Jalankan pembantu penyiapan dan perbaikan Crestodian dari DM pemilik |
/tasks |
Cantumkan tugas latar belakang yang aktif/terbaru untuk sesi saat ini |
/context [list|detail|map|json] |
Jelaskan cara konteks disusun |
/whoami |
Tampilkan ID pengirim Anda. Alias: /id |
/usage off|tokens|full|reset|cost |
Kendalikan catatan kaki penggunaan per respons (reset/inherit/clear/default menghapus penggantian sesi agar kembali mewarisi nilai bawaan yang dikonfigurasi) atau tampilkan ringkasan biaya lokal |
Skills, daftar izin, persetujuan
| Perintah | Deskripsi |
|---|---|
/skill <name> [input] |
Jalankan skill berdasarkan nama |
/learn [request] |
Susun draf satu skill yang dapat ditinjau dari percakapan saat ini atau sumber yang disebutkan melalui Lokakarya Skill |
/allowlist [list|add|remove] ... |
Kelola entri daftar izin. Hanya teks |
/approve <id> <decision> |
Selesaikan permintaan persetujuan eksekusi atau plugin |
/btw <question> |
Ajukan pertanyaan sampingan tanpa mengubah konteks sesi. Alias: /side. Lihat BTW |
Subagen dan ACP
| Perintah | Deskripsi |
|---|---|
/subagents list|log|info |
Periksa eksekusi subagen untuk sesi saat ini |
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help |
Kelola sesi ACP dan opsi runtime. Kontrol runtime memerlukan identitas pemilik eksternal atau admin Gateway internal |
/focus <target> |
Kaitkan utas Discord atau topik Telegram saat ini ke target sesi |
/unfocus |
Hapus pengaitan utas saat ini |
/agents |
Cantumkan agen yang terikat ke utas untuk sesi saat ini |
Penulisan khusus pemilik dan administrasi
| Perintah | Memerlukan | Deskripsi |
|---|---|---|
/config show|get|set|unset |
commands.config: true |
Baca atau tulis openclaw.json. Khusus pemilik |
/mcp show|get|set|unset |
commands.mcp: true |
Baca atau tulis konfigurasi server MCP yang dikelola OpenClaw. Khusus pemilik |
/plugins list|inspect|show|get|install|enable|disable |
commands.plugins: true |
Periksa atau ubah status plugin. Penulisan khusus pemilik. Alias: /plugin |
/debug show|set|unset|reset |
commands.debug: true |
Penggantian konfigurasi khusus runtime. Khusus pemilik |
/restart |
commands.restart: true (bawaan) |
Mulai ulang OpenClaw |
/send on|off|inherit |
pemilik | Atur kebijakan pengiriman |
Suara, TTS, kontrol kanal
| Perintah | Deskripsi |
|---|---|
/tts on|off|status|chat|latest|provider|limit|summary|audio|help |
Kontrol TTS. Lihat TTS |
/activation mention|always |
Atur mode aktivasi grup |
/bash <command> |
Jalankan perintah shell hos. Alias: ! <command>. Memerlukan commands.bash: true |
!poll [sessionId] |
Periksa tugas bash latar belakang |
!stop [sessionId] |
Hentikan tugas bash latar belakang |
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)
Perintah docking memerlukan session.identityLinks. Pengirim sumber dan rekan target
harus berada dalam grup identitas yang sama.
Perintah plugin bawaan
| Perintah | Deskripsi |
|---|---|
/dreaming [on|off|status|help] |
Aktifkan atau nonaktifkan dreaming memori (pemilik atau admin Gateway). Lihat Dreaming |
/pair [qr|status|pending|approve|cleanup|notify] |
Kelola pemasangan perangkat. Lihat Pemasangan |
/phone status|arm ...|disarm |
Aktifkan sementara perintah Node berisiko tinggi (kamera/layar/komputer/penulisan). Lihat Penggunaan komputer |
/voice status|list|set <voiceId> |
Kelola konfigurasi suara Talk. Nama native Discord: /talkvoice |
/card ... |
Kirim preset kartu kaya LINE. Lihat LINE |
/codex <action> ... |
Kaitkan, arahkan, dan periksa harness server aplikasi Codex (status, utas, lanjutkan, model, cepat, izin, pemadatan, peninjauan, mcp, skills, dan lainnya). Lihat Harness Codex |
Khusus QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs
Perintah Skills
Skills yang dapat dipanggil pengguna diekspos sebagai perintah garis miring:
/skill <name> [input]selalu berfungsi sebagai titik masuk umum.- Skills dapat didaftarkan sebagai perintah langsung (misalnya
/proseuntuk OpenProse). - Pendaftaran perintah Skills native dikontrol oleh
commands.nativeSkillsdanchannels.<provider>.commands.nativeSkills. - Nama disanitasi menjadi
a-z0-9_(maks. 32 karakter); tabrakan mendapatkan sufiks numerik.
Pengiriman perintah Skills
Secara bawaan, perintah Skills dirutekan ke model sebagai permintaan biasa.
Skills dapat mendeklarasikan command-dispatch: tool untuk merutekan langsung ke alat
(deterministik, tanpa keterlibatan model). Contoh: /prose (plugin OpenProse)
— lihat OpenProse.
Argumen perintah native
Discord menggunakan pelengkapan otomatis untuk opsi dinamis dan menu tombol ketika
argumen wajib 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 saat ini
/tools menjawab pertanyaan runtime: apa yang dapat digunakan agen ini sekarang dalam
percakapan ini — bukan katalog konfigurasi statis.
/tools # tampilan ringkas/tools verbose # dengan deskripsi singkatHasil dibatasi per sesi. Mengubah agen, kanal, utas, otorisasi pengirim, atau model dapat mengubah keluaran. Untuk mengedit profil dan penggantian, gunakan panel Alat UI Kontrol atau permukaan konfigurasi.
/model: pemilihan model
/model # tampilkan pemilih model/model list # sama/model 3 # pilih berdasarkan nomor dari pemilih/model openai/gpt-5.4/model opus@anthropic:default/model default # hapus pilihan model sesi/model status # tampilan terperinci dengan endpoint dan mode APIDi Discord, /model dan /models membuka pemilih interaktif dengan menu tarik-turun
penyedia dan model. Pemilih mematuhi agents.defaults.models, termasuk
entri provider/*.
/config: penulisan konfigurasi pada disk
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixKonfigurasi divalidasi sebelum ditulis. Perubahan yang tidak valid ditolak. Pembaruan /config
tetap tersimpan setelah mulai ulang.
/mcp: konfigurasi server MCP
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7/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 privat kepada pemilik; jika tidak tersedia rute privat ke
pemilik, perintah gagal secara tertutup dan meminta pemilik mencoba lagi dari percakapan
langsung.
/debug: penggantian khusus runtime
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins: pengelolaan plugin
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin/plugins enable|disable memperbarui konfigurasi plugin dan memuat ulang secara langsung runtime
plugin Gateway untuk giliran agen baru. /plugins install memulai ulang Gateway
terkelola secara otomatis karena modul sumber plugin berubah.
/trace: keluaran pelacakan plugin
/trace # tampilkan status pelacakan saat ini/trace on/trace off/trace menampilkan baris pelacakan/debug plugin yang dibatasi per sesi tanpa mode
verbose penuh. Ini tidak menggantikan /debug (penggantian runtime) atau /verbose (keluaran
alat normal).
/btw: pertanyaan sampingan
/btw adalah pertanyaan sampingan singkat tentang konteks sesi saat ini. Alias: /side.
/btw what are we doing right now?/side what changed while the main run continued?Tidak seperti pesan biasa:
- Menggunakan sesi saat ini sebagai konteks latar belakang.
- Dalam sesi harness Codex, berjalan sebagai utas sampingan Codex sementara.
- Tidak mengubah konteks sesi berikutnya.
- Tidak ditulis ke riwayat transkrip.
Lihat Pertanyaan sampingan BTW untuk perilaku lengkap.
Catatan permukaan
Cakupan sesi per permukaan
- Perintah teks: berjalan dalam sesi percakapan normal (DM berbagi
main, grup memiliki sesi masing-masing). - Perintah native Discord:
agent:<agentId>:discord:slash:<userId> - Perintah native Slack:
agent:<agentId>:slack:slash:<userId>(prefiks dapat dikonfigurasi melaluichannels.slack.slashCommand.sessionPrefix) - Perintah native Telegram:
telegram:slash:<userId>(menargetkan sesi percakapan melaluiCommandTargetSessionKey) /login codexmengirim kode pemasangan perangkat hanya melalui percakapan privat atau jalur respons UI Web. Pemanggilan dari grup/topik Telegram meminta pemilik mengirim DM ke bot sebagai gantinya./stopmenargetkan sesi percakapan aktif untuk membatalkan eksekusi saat ini.
Kekhususan 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
- Pesan yang hanya berisi perintah dari pengirim dalam daftar izin ditangani segera (melewati antrean + model).
- Pintasan sebaris (
/help,/commands,/status,/whoami) juga berfungsi ketika disematkan dalam pesan biasa dan dihapus sebelum model melihat teks yang tersisa. - Pesan yang hanya berisi perintah dari pengirim tanpa otorisasi diabaikan tanpa pemberitahuan; token
/...sebaris diperlakukan sebagai teks biasa.
Catatan argumen
- Perintah menerima
:opsional antara perintah dan argumen (/think: high,/send: on). /new <model>menerima alias model,provider/model, atau nama penyedia (pencocokan samar); jika tidak ada kecocokan, teks 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 alternatif ketika snapshot sesi langsung minim data. - Eksekusi vs runtime:
/statusmelaporkanExecutionuntuk jalur sandbox efektif danRuntimeuntuk pihak yang menjalankan sesi:OpenClaw Default,OpenAI Codex, backend CLI, atau backend ACP. - Token/biaya per respons: dikendalikan oleh
/usage off|tokens|full. /model statusmembahas model/autentikasi/endpoint, bukan penggunaan.