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).
Ketika percakapan terikat ke sesi ACP, teks biasa diarahkan ke harness ACP.
Perintah manajemen Gateway tetap lokal: /acp ... selalu mencapai penangan perintah OpenClaw, dan /status serta /unfocus tetap lokal setiap kali penanganan perintah diaktifkan untuk surface 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 inline saat dikirim bersama teks lain.
/help, /commands, /status, /whoami — langsung dijalankan dan
dihapus sebelum model melihat teks yang tersisa. Hanya pengirim berwenang.
Detail perilaku direktif
- Direktif dihapus dari pesan sebelum model melihatnya.
- Dalam pesan hanya direktif (pesan hanya berisi direktif), direktif dipertahankan ke sesi dan membalas dengan pengakuan.
- Dalam pesan obrolan normal dengan teks lain, direktif bertindak sebagai petunjuk inline dan tidak mempertahankan pengaturan sesi.
- Direktif hanya berlaku untuk pengirim berwenang. Jika
commands.allowFromditetapkan, itu adalah satu-satunya allowlist yang digunakan; jika tidak, otorisasi berasal dari allowlist/pairing channel pluscommands.useAccessGroups. Pengirim yang tidak berwenang 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 parsing /... dalam pesan obrolan. Pada surface tanpa perintah native
(WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), perintah
teks tetap berfungsi meski ditetapkan ke false.
commands.nativeboolean | "auto"default: "auto"Mendaftarkan perintah native. Auto: aktif untuk Discord/Telegram; nonaktif untuk Slack;
diabaikan untuk provider tanpa dukungan native. Timpa per channel dengan
channels.<provider>.commands.native. Di Discord, false melewati pendaftaran slash-command;
perintah yang sebelumnya terdaftar mungkin tetap terlihat sampai dihapus.
commands.nativeSkillsboolean | "auto"default: "auto"Mendaftarkan perintah skill secara native saat didukung. Auto: 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
allowlist tools.elevated.
commands.bashForegroundMsnumberdefault: 2000Berapa lama bash menunggu sebelum beralih ke mode latar belakang (0 langsung
ke latar belakang).
commands.configbooleandefault: falseMengaktifkan /config (membaca/menulis openclaw.json). Hanya owner.
commands.mcpbooleandefault: falseMengaktifkan /mcp (membaca/menulis konfigurasi MCP yang dikelola OpenClaw di bawah mcp.servers). Hanya owner.
commands.pluginsbooleandefault: falseMengaktifkan /plugins (penemuan/status plugin plus instal + aktifkan/nonaktifkan). Hanya owner untuk penulisan.
commands.debugbooleandefault: falseMengaktifkan /debug (override konfigurasi khusus runtime). Hanya owner.
commands.restartbooleandefault: trueMengaktifkan /restart dan aksi alat restart gateway.
commands.ownerAllowFromstring[]Allowlist owner eksplisit untuk surface perintah khusus owner. Terpisah dari
commands.allowFrom dan akses pairing DM.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
Per channel: memerlukan identitas owner untuk perintah khusus owner. Saat true,
pengirim harus cocok dengan commands.ownerAllowFrom atau memiliki cakupan internal operator.admin.
Entri wildcard allowFrom tidak cukup.
commands.ownerDisplay"raw" | "hash"Mengontrol bagaimana id owner muncul dalam prompt sistem.
commands.ownerDisplaySecretstringRahasia HMAC yang digunakan saat commands.ownerDisplay: "hash".
commands.allowFromobjectAllowlist per provider untuk otorisasi perintah. Saat dikonfigurasi, ini adalah
satu-satunya sumber otorisasi untuk perintah dan direktif. Gunakan "*" untuk
default global; kunci khusus provider menimpanya.
commands.useAccessGroupsbooleandefault: trueMenegakkan allowlist/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: panggilan
registerCommand()plugin
Ketersediaan bergantung pada flag konfigurasi, surface channel, dan plugin yang terinstal/diaktifkan.
Perintah inti
Sesi dan run
| Perintah | Deskripsi |
|---|---|
/new [model] |
Arsipkan sesi saat ini dan mulai yang baru |
/reset [soft [message]] |
Reset sesi saat ini di tempat. soft mempertahankan transkrip, membuang id sesi backend CLI yang digunakan ulang, dan menjalankan ulang startup |
/name <title> |
Beri nama atau ganti nama sesi saat ini. Hilangkan judul untuk melihat nama saat ini dan saran |
/compact [instructions] |
Padatkan konteks sesi. Lihat Compaction |
/stop |
Batalkan run saat ini |
/session idle <duration|off> |
Kelola kedaluwarsa idle thread-binding |
/session max-age <duration|off> |
Kelola kedaluwarsa usia maksimum thread-binding |
/export-session [path] |
Ekspor sesi saat ini ke HTML. Alias: /export |
/export-trajectory [path] |
Ekspor bundle trajectory JSONL untuk sesi saat ini. Alias: /trajectory |
Kontrol model dan run
| Perintah | Deskripsi |
|---|---|
/think <level|default> |
Tetapkan tingkat berpikir atau hapus override sesi. Alias: /thinking, /t |
/verbose on|off|full |
Aktifkan/nonaktifkan output verbose. Alias: /v |
/trace on|off |
Aktifkan/nonaktifkan output trace plugin untuk sesi saat ini |
/fast [status|auto|on|off|default] |
Tampilkan, tetapkan, atau hapus mode cepat |
/reasoning [on|off|stream] |
Aktifkan/nonaktifkan visibilitas reasoning. Alias: /reason |
/elevated [on|off|ask|full] |
Aktifkan/nonaktifkan mode elevated. Alias: /elev |
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> |
Tampilkan atau tetapkan default exec |
/login [codex|openai|openai-codex] |
Pair login Codex/OpenAI dari obrolan privat atau sesi Web UI. Hanya owner/admin |
/model [name|#|status] |
Tampilkan atau tetapkan model |
/models [provider] [page] [limit=<n>|all] |
Cantumkan provider atau model yang dikonfigurasi/tersedia auth |
/queue <mode> |
Kelola perilaku antrean run aktif. Lihat Antrean dan Pengarahan antrean |
/steer <message> |
Injeksi panduan ke dalam run aktif. Alias: /tell. Lihat Steer |
keamanan verbose / trace / fast / reasoning
/verboseuntuk debugging — biarkan nonaktif dalam penggunaan normal./tracehanya mengungkap baris trace/debug milik plugin; obrolan verbose normal tetap nonaktif./fast auto|on|offmempertahankan override sesi; gunakan opsiinheritdi Sessions UI untuk menghapusnya./fastkhusus provider: OpenAI/Codex memetakannya keservice_tier=priority; permintaan Anthropic langsung memetakannya keservice_tier=autoataustandard_only./reasoning,/verbose, dan/traceberisiko dalam pengaturan grup — ini dapat mengungkap reasoning internal atau diagnostik plugin. Biarkan nonaktif di obrolan grup.
Detail penggantian model
/modelsegera mempertahankan model baru ke sesi.- Jika agent idle, run berikutnya langsung menggunakannya.
- Jika run aktif, penggantian ditandai tertunda dan diterapkan pada titik retry bersih berikutnya.
Penemuan dan status
| Perintah | Deskripsi |
|---|---|
/help |
Tampilkan ringkasan bantuan singkat |
/commands |
Tampilkan katalog perintah yang dihasilkan |
/tools [compact|verbose] |
Tampilkan apa yang dapat digunakan agent saat ini sekarang |
/status |
Tampilkan status eksekusi/runtime, waktu aktif Gateway dan sistem, kesehatan plugin, plus penggunaan/kuota provider |
/status plugins |
Tampilkan kesehatan plugin terperinci: error pemuatan, karantina, kegagalan channel, masalah dependensi, pemberitahuan kompatibilitas |
/goal [status|start|pause|resume|complete|block|clear] ... |
Kelola tujuan tahan lama sesi saat ini |
/diagnostics [note] |
Alur laporan dukungan khusus owner. Meminta persetujuan exec setiap kali |
/crestodian <request> |
Jalankan pembantu penyiapan dan perbaikan Crestodian dari DM owner |
/tasks |
Cantumkan tugas latar belakang aktif/terbaru untuk sesi saat ini |
/context [list|detail|map|json] |
Jelaskan bagaimana konteks disusun |
/whoami |
Tampilkan id pengirim Anda. Alias: /id |
/usage off|tokens|full|reset|cost |
Kontrol footer penggunaan per respons (reset/inherit/clear/default menghapus override sesi untuk kembali mewarisi default yang dikonfigurasi) atau cetak ringkasan biaya lokal |
Skills, allowlist, persetujuan
| Perintah | Deskripsi |
|---|---|
/skill <name> [input] |
Jalankan skill berdasarkan nama |
/allowlist [list|add|remove] ... |
Kelola entri allowlist. Hanya teks |
/approve <id> <decision> |
Selesaikan prompt persetujuan exec 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 proses 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 pemilik eksternal atau identitas admin Gateway internal |
/focus <target> |
Ikat thread Discord atau topik Telegram saat ini ke target sesi |
/unfocus |
Hapus ikatan thread saat ini |
/agents |
Cantumkan agen yang terikat thread untuk sesi saat ini |
Penulisan khusus pemilik dan admin
| Perintah | Membutuhkan | 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. Khusus pemilik untuk penulisan. Alias: /plugin |
/debug show|set|unset|reset |
commands.debug: true |
Penggantian konfigurasi khusus runtime. Khusus pemilik |
/restart |
commands.restart: true (default) |
Mulai ulang OpenClaw |
/send on|off|inherit |
pemilik | Atur kebijakan pengiriman |
Suara, TTS, kontrol saluran
| 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 host. Alias: ! <command>. Memerlukan commands.bash: true |
!poll [sessionId] |
Periksa pekerjaan bash latar belakang |
!stop [sessionId] |
Hentikan pekerjaan bash latar belakang |
Perintah dock
Perintah dock mengalihkan rute balasan sesi aktif ke saluran tertaut lain. Lihat Channel docking untuk penyiapan dan pemecahan masalah.
Dihasilkan dari plugin saluran 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 dock memerlukan session.identityLinks. Pengirim sumber dan peer target
harus berada dalam grup identitas yang sama.
Perintah plugin bawaan
| Perintah | Deskripsi |
|---|---|
/dreaming [on|off|status|help] |
Aktifkan/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 ponsel berisiko tinggi |
/voice status|list|set <voiceId> |
Kelola konfigurasi suara Talk. Nama native Discord: /talkvoice |
/card ... |
Kirim preset kartu kaya LINE. Lihat LINE |
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills |
Kontrol harness server aplikasi Codex. Lihat Harness Codex |
Khusus QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs
Perintah Skill
Skill yang dapat dipanggil pengguna diekspos sebagai perintah slash:
/skill <name> [input]selalu berfungsi sebagai titik masuk generik.- Skills dapat mendaftar sebagai perintah langsung (misalnya
/proseuntuk OpenProse). - Pendaftaran perintah skill native dikontrol oleh
commands.nativeSkillsdanchannels.<provider>.commands.nativeSkills. - Nama disanitasi menjadi
a-z0-9_(maks 32 karakter); tabrakan mendapat sufiks numerik.
Dispatch perintah Skill
Secara default, 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
Discord menggunakan pelengkapan otomatis untuk opsi dinamis dan menu tombol saat argumen
wajib dihilangkan. Telegram dan Slack menampilkan menu tombol untuk perintah dengan
pilihan. Pilihan dinamis diselesaikan terhadap model sesi target, sehingga opsi spesifik
model seperti level /think mengikuti penggantian /model milik sesi.
/tools — yang dapat digunakan agen sekarang
/tools menjawab pertanyaan runtime: apa yang dapat digunakan agen ini sekarang dalam
percakapan ini — bukan katalog konfigurasi statis.
/tools # compact view/tools verbose # with short descriptionsHasil dicakup per sesi. Mengubah agen, saluran, thread, otorisasi pengirim, atau model dapat mengubah keluaran. Untuk pengeditan profil dan penggantian, gunakan panel Tools di Control UI atau permukaan konfigurasi.
/model — pemilihan model
/model # show model picker/model list # same/model 3 # select by number from picker/model openai/gpt-5.4/model opus@anthropic:default/model default # clear the session model selection/model status # detailed view with endpoint and API modeDi Discord, /model dan /models membuka pemilih interaktif dengan dropdown penyedia dan
model. Pemilih mematuhi agents.defaults.models, termasuk entri
provider/*.
/config — penulisan konfigurasi di disk
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixKonfigurasi divalidasi sebelum ditulis. Perubahan tidak valid ditolak. Pembaruan /config
bertahan lintas 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 di konfigurasi OpenClaw, bukan di pengaturan proyek agen tersemat.
/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 — manajemen 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 panas runtime
plugin Gateway untuk giliran agen baru. /plugins install memulai ulang Gateway yang dikelola
secara otomatis karena modul sumber plugin berubah.
/trace — keluaran trace plugin
/trace # show current trace state/trace on/trace off/trace mengungkap baris trace/debug plugin yang dicakup per 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.
/btw what are we doing right now?/side what changed while the main run continued?Tidak seperti pesan normal:
- Menggunakan sesi saat ini sebagai konteks latar belakang.
- Dalam sesi harness Codex, berjalan sebagai thread sampingan Codex sementara.
- Tidak mengubah konteks sesi mendatang.
- Tidak ditulis ke riwayat transkrip.
Lihat Pertanyaan sampingan BTW untuk perilaku lengkap.
Catatan permukaan
Cakupan sesi per permukaan
- Perintah teks: berjalan dalam sesi chat normal (DM berbagi
main, grup memiliki sesi sendiri). - 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 chat melaluiCommandTargetSessionKey) /login codexmengirim kode pemasangan perangkat hanya melalui chat pribadi atau jalur respons Web UI. Pemanggilan grup/topik Telegram meminta pemilik untuk mengirim DM ke bot sebagai gantinya./stopmenargetkan sesi chat aktif untuk membatalkan proses saat ini.
Kekhususan Slack
channels.slack.slashCommand mendukung satu perintah bergaya /openclaw.
Dengan commands.native: true, buat satu perintah slash Slack per perintah
bawaan. Daftarkan /agentstatus (bukan /status) karena Slack mencadangkan
/status. Teks /status tetap berfungsi di pesan Slack.
Jalur cepat dan pintasan inline
- Pesan yang hanya berisi perintah dari pengirim dalam allowlist ditangani segera (melewati antrean + model).
- Pintasan inline (
/help,/commands,/status,/whoami) juga berfungsi saat disematkan dalam pesan normal dan dihapus sebelum model melihat teks sisanya. - Pesan yang hanya berisi perintah dari pengirim tanpa otorisasi diabaikan secara diam-diam; token inline
/...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 fuzzy); jika tidak ada kecocokan, teks diperlakukan sebagai isi pesan./allowlist add|removememerlukancommands.config: truedan mematuhiconfigWritessaluran.
Penggunaan dan status penyedia
- Penggunaan/kuota penyedia (misalnya, "Claude 80% left") ditampilkan di
/statusuntuk penyedia model saat ini ketika pelacakan penggunaan diaktifkan. - Baris token/cache di
/statusdapat fallback ke entri penggunaan transkrip terbaru saat snapshot sesi live jarang. - Eksekusi vs runtime:
/statusmelaporkanExecutionuntuk jalur sandbox efektif danRuntimeuntuk siapa yang menjalankan sesi:OpenClaw Default,OpenAI Codex, backend CLI, atau backend ACP. - Token/biaya per respons: dikontrol oleh
/usage off|tokens|full. /model statusmembahas model/auth/endpoint, bukan penggunaan.