Tingkat berpikir

Fungsinya

• Direktif sebaris dalam badan masuk apa pun: /t <level>, /think:<level>, atau /thinking <level>.
• Level (alias): off | minimal | low | medium | high | xhigh | adaptive | max
  • minimal → "think"
  • low → "think hard"
  • medium → "think harder"
  • high → "ultrathink" (anggaran maksimal)
  • xhigh → "ultrathink+" (model GPT-5.2+ dan Codex, ditambah upaya Anthropic Claude Opus 4.7+)
  • adaptive → berpikir adaptif yang dikelola penyedia (didukung untuk Claude 4.6 di Anthropic/Bedrock, Anthropic Claude Opus 4.7+, dan Google Gemini dynamic thinking)
  • max → penalaran maksimal penyedia (Anthropic Claude Opus 4.7+; Ollama memetakan ini ke upaya native think tertingginya)
  • x-high, x_high, extra-high, extra high, dan extra_high dipetakan ke xhigh.
  • highest dipetakan ke high.
• Catatan penyedia:
  • Menu dan pemilih thinking digerakkan oleh profil penyedia. Plugin penyedia mendeklarasikan kumpulan level persis untuk model yang dipilih, termasuk label seperti biner on.
  • adaptive, xhigh, dan max hanya ditampilkan untuk profil penyedia/model yang mendukungnya. Direktif bertipe untuk level yang tidak didukung ditolak dengan opsi valid model tersebut.
  • Level tersimpan yang tidak didukung dipetakan ulang berdasarkan peringkat profil penyedia. adaptive mundur ke medium pada model non-adaptif, sedangkan xhigh dan max mundur ke level non-off terbesar yang didukung untuk model yang dipilih.
  • Model Anthropic Claude 4.6 default ke adaptive ketika tidak ada level thinking eksplisit yang ditetapkan.
  • Anthropic Claude Opus 4.8 dan Opus 4.7 tetap menonaktifkan thinking kecuali Anda menetapkan level thinking secara eksplisit. Default upaya milik penyedia Opus 4.8 adalah high setelah adaptive thinking diaktifkan.
  • Anthropic Claude Opus 4.7+ memetakan /think xhigh ke adaptive thinking ditambah output_config.effort: "xhigh", karena /think adalah direktif thinking dan xhigh adalah pengaturan upaya Opus.
  • Anthropic Claude Opus 4.7+ juga mengekspos /think max; ini dipetakan ke jalur upaya maksimal milik penyedia yang sama.
  • Model Direct DeepSeek V4 mengekspos /think xhigh|max; keduanya dipetakan ke DeepSeek reasoning_effort: "max" sementara level non-off yang lebih rendah dipetakan ke high.
  • Model DeepSeek V4 yang dirutekan OpenRouter mengekspos /think xhigh dan mengirim nilai reasoning.effort yang didukung OpenRouter alih-alih reasoning_effort tingkat atas native DeepSeek. Level non-off yang lebih rendah dipetakan ke high, dan override max tersimpan mundur ke xhigh.
  • Model Ollama yang mendukung thinking mengekspos /think low|medium|high|max; max dipetakan ke native think: "high" karena API native Ollama menerima string upaya low, medium, dan high.
  • Model OpenAI GPT memetakan /think melalui dukungan upaya Responses API yang spesifik model. /think off mengirim reasoning.effort: "none" hanya ketika model target mendukungnya; jika tidak, OpenClaw menghilangkan payload penalaran yang dinonaktifkan alih-alih mengirim nilai yang tidak didukung.
  • Entri katalog kustom yang kompatibel dengan OpenAI dapat ikut menggunakan /think xhigh dengan menetapkan models.providers.<provider>.models[].compat.supportedReasoningEfforts agar menyertakan "xhigh". Ini menggunakan metadata kompatibilitas yang sama yang memetakan payload upaya penalaran OpenAI keluar, sehingga menu, validasi sesi, CLI agen, dan llm-task selaras dengan perilaku transport.
  • Ref OpenRouter Hunter Alpha terkonfigurasi yang usang melewati injeksi penalaran proxy karena rute yang sudah dihentikan itu dapat mengembalikan teks jawaban final melalui bidang penalaran.
  • Google Gemini memetakan /think adaptive ke dynamic thinking milik penyedia Gemini. Permintaan Gemini 3 menghilangkan thinkingLevel tetap, sementara permintaan Gemini 2.5 mengirim thinkingBudget: -1; level tetap masih dipetakan ke thinkingLevel atau anggaran Gemini terdekat untuk keluarga model tersebut.
  • MiniMax M2.x (minimax/MiniMax-M2*) pada jalur streaming yang kompatibel dengan Anthropic default ke thinking: { type: "disabled" } kecuali Anda menetapkan thinking secara eksplisit dalam parameter model atau parameter permintaan. Ini menghindari delta reasoning_content yang bocor dari format stream Anthropic non-native M2.x. MiniMax-M3 (dan M3.x) dikecualikan: M3 memancarkan blok thinking Anthropic yang benar dan mengembalikan konten kosong ketika thinking dinonaktifkan, sehingga OpenClaw mempertahankan M3 pada jalur thinking adaptif/dihilangkan milik penyedia.
  • Z.AI (zai/*) bersifat biner (on/off) untuk sebagian besar model GLM. GLM-5.2 adalah pengecualian: model ini mengekspos /think off|low|high|max, memetakan low dan high ke Z.AI reasoning_effort: "high", dan memetakan max ke reasoning_effort: "max".
  • Moonshot Kimi K2.7 Code (moonshot/kimi-k2.7-code) selalu berpikir. Profilnya hanya mengekspos on, dan OpenClaw menghilangkan bidang thinking keluar seperti yang diwajibkan Moonshot. Model moonshot/* lain memetakan /think off ke thinking: { type: "disabled" } dan level non-off apa pun ke thinking: { type: "enabled" }. Ketika thinking diaktifkan, Moonshot hanya menerima tool_choice auto|none; OpenClaw menormalkan nilai yang tidak kompatibel menjadi auto.

Urutan resolusi

1. Direktif sebaris pada pesan (hanya berlaku untuk pesan tersebut).
2. Override sesi (ditetapkan dengan mengirim pesan yang hanya berisi direktif).
3. Default per agen (agents.list[].thinkingDefault dalam konfigurasi).
4. Default global (agents.defaults.thinkingDefault dalam konfigurasi).
5. Fallback: default yang dideklarasikan penyedia ketika tersedia; jika tidak, model yang mampu bernalar diselesaikan ke medium atau level non-off terdekat yang didukung untuk model tersebut, dan model yang tidak bernalar tetap off.

Menetapkan default sesi

• Kirim pesan yang hanya berisi direktif (spasi kosong diperbolehkan), misalnya /think:medium atau /t high.
• Itu tetap berlaku untuk sesi saat ini (defaultnya per pengirim). Gunakan /think default untuk menghapus override sesi dan mewarisi default konfigurasi/penyedia; alias mencakup inherit, clear, reset, dan unpin.
• /think off menyimpan override off eksplisit. Ini menonaktifkan thinking sampai Anda mengubah atau menghapus override sesi.
• Balasan konfirmasi dikirim (Thinking level set to high. / Thinking disabled.). Jika level tidak valid (misalnya /thinking big), perintah ditolak dengan petunjuk dan status sesi dibiarkan tidak berubah.
• Kirim /think (atau /think:) tanpa argumen untuk melihat level thinking saat ini.

Penerapan berdasarkan agen

• OpenClaw tertanam: level yang diselesaikan diteruskan ke runtime agen OpenClaw dalam proses.
• Backend Claude CLI: level non-off diteruskan ke Claude Code sebagai --effort saat menggunakan claude-cli; lihat Backend CLI.

Mode cepat (/fast)

• Level: auto|on|off|default.
• Pesan yang hanya berisi direktif mengaktifkan override mode cepat sesi dan membalas Fast mode set to auto., Fast mode enabled., atau Fast mode disabled.. Gunakan /fast default untuk menghapus override sesi dan mewarisi default terkonfigurasi; alias mencakup inherit, clear, reset, dan unpin.
• Kirim /fast (atau /fast status) tanpa mode untuk melihat status mode cepat efektif saat ini.
• OpenClaw menyelesaikan mode cepat dalam urutan ini:
  1. Override /fast auto|on|off sebaris/hanya-direktif (/fast default menghapus lapisan ini)
  2. Override sesi
  3. Default per agen (agents.list[].fastModeDefault)
  4. Konfigurasi per model: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. Fallback: off
• auto mempertahankan mode sesi/konfigurasi sebagai auto tetapi menyelesaikan setiap panggilan model baru secara independen. Panggilan yang dimulai sebelum batas auto mengaktifkan mode cepat; panggilan retry, fallback, hasil tool, atau lanjutan yang lebih lambat dimulai dengan mode cepat dinonaktifkan. Batas defaultnya 60 detik; tetapkan agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds pada model aktif untuk mengubahnya.
• Untuk openai/*, mode cepat dipetakan ke pemrosesan prioritas OpenAI dengan mengirim service_tier=priority pada permintaan Responses yang didukung.
• Untuk model openai/* / openai-codex/* yang didukung Codex, mode cepat mengirim flag service_tier=priority yang sama pada Codex Responses. Giliran app-server Codex native menerima tier hanya pada turn/start atau mulai/lanjutkan thread, sehingga auto tidak dapat mengganti tier satu giliran app-server yang sudah berjalan; ini berlaku pada giliran model berikutnya yang dimulai OpenClaw.
• Untuk permintaan publik langsung anthropic/*, termasuk lalu lintas terautentikasi OAuth yang dikirim ke api.anthropic.com, mode cepat dipetakan ke tier layanan Anthropic: /fast on menetapkan service_tier=auto, /fast off menetapkan service_tier=standard_only.
• Untuk minimax/* pada jalur yang kompatibel dengan Anthropic, /fast on (atau params.fastMode: true) menulis ulang MiniMax-M2.7 menjadi MiniMax-M2.7-highspeed.
• Parameter model Anthropic serviceTier / service_tier eksplisit mengesampingkan default mode cepat ketika keduanya ditetapkan. OpenClaw tetap melewati injeksi tier layanan Anthropic untuk URL dasar proxy non-Anthropic.
• /status menampilkan Fast ketika mode cepat diaktifkan dan Fast:auto ketika mode terkonfigurasi adalah auto.

Direktif verbose (/verbose atau /v)

• Level: on (minimal) | full | off (default).
• Pesan yang hanya berisi direktif mengaktifkan verbose sesi dan membalas Verbose logging enabled. / Verbose logging disabled.; level tidak valid mengembalikan petunjuk tanpa mengubah status.
• /verbose off menyimpan override sesi eksplisit; hapus melalui UI Sesi dengan memilih inherit.
• Pengirim kanal eksternal yang berwenang dapat mempertahankan override verbose sesi. Klien gateway/webchat internal memerlukan operator.admin untuk mempertahankannya.
• Direktif sebaris hanya memengaruhi pesan tersebut; default sesi/global berlaku selain itu.
• Kirim /verbose (atau /verbose:) tanpa argumen untuk melihat level verbose saat ini.
• Ketika verbose aktif, agen yang memancarkan hasil tool terstruktur mengirim setiap panggilan tool kembali sebagai pesan metadata-saja sendiri, diawali dengan <emoji> <tool-name>: <arg> jika tersedia. Ringkasan tool ini dikirim segera setelah setiap tool dimulai (gelembung terpisah), bukan sebagai delta streaming.
• Ringkasan kegagalan tool tetap terlihat dalam mode normal, tetapi sufiks detail kesalahan mentah disembunyikan kecuali verbose adalah full.
• Ketika verbose adalah full, keluaran tool juga diteruskan setelah selesai (gelembung terpisah, dipotong ke panjang aman). Jika Anda mengaktifkan /verbose on|full|off saat sebuah run sedang berlangsung, gelembung tool berikutnya mengikuti pengaturan baru.
• agents.defaults.toolProgressDetail mengontrol bentuk ringkasan tool /verbose dan baris tool draf progres. Gunakan "explain" (default) untuk label manusia yang ringkas seperti 🛠️ Exec: checking JS syntax; gunakan "raw" ketika Anda juga ingin perintah/detail mentah ditambahkan untuk debugging. agents.list[].toolProgressDetail per agen mengesampingkan default.
  • explain: 🛠️ Exec: check JS syntax for /tmp/app.js
  • raw: 🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js

Direktif trace Plugin (/trace)

• Level: on | off (default).
• Pesan yang hanya berisi direktif mengaktifkan keluaran trace Plugin sesi dan membalas Plugin trace enabled. / Plugin trace disabled..
• Direktif sebaris hanya memengaruhi pesan tersebut; default sesi/global berlaku selain itu.
• Kirim /trace (atau /trace:) tanpa argumen untuk melihat level trace saat ini.
• /trace lebih sempit daripada /verbose: ini hanya mengekspos baris trace/debug milik Plugin seperti ringkasan debug Active Memory.
• Baris trace dapat muncul di /status dan sebagai pesan diagnostik lanjutan setelah balasan asisten normal.

Visibilitas penalaran (/reasoning)

• Level: on|off|stream.
• Pesan yang hanya berisi direktif mengaktifkan apakah blok thinking ditampilkan dalam balasan.
• Ketika diaktifkan, penalaran dikirim sebagai pesan terpisah yang diawali dengan Thinking.
• stream: men-stream penalaran saat balasan sedang dibuat ketika kanal aktif mendukung pratinjau penalaran, lalu mengirim jawaban final tanpa penalaran.
• Alias: /reason.
• Kirim /reasoning (atau /reasoning:) tanpa argumen untuk melihat level penalaran saat ini.
• Urutan resolusi: direktif sebaris, lalu override sesi, lalu default per agen (agents.list[].reasoningDefault), lalu default global (agents.defaults.reasoningDefault), lalu fallback (off).

Tag penalaran model lokal yang salah format ditangani secara konservatif. Blok <think>...</think> yang tertutup tetap disembunyikan pada balasan normal, dan penalaran yang tidak tertutup setelah teks yang sudah terlihat juga disembunyikan. Jika sebuah balasan sepenuhnya dibungkus dalam satu tag pembuka yang tidak tertutup dan jika tidak demikian akan dikirim sebagai teks kosong, OpenClaw menghapus tag pembuka yang salah format tersebut dan mengirim teks yang tersisa.

Terkait

• Dokumentasi mode elevated ada di Mode elevated.

Heartbeat

• Isi probe Heartbeat adalah prompt heartbeat yang dikonfigurasi (default: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.). Arahan inline dalam pesan heartbeat berlaku seperti biasa (tetapi hindari mengubah default sesi dari heartbeat).
• Pengiriman Heartbeat secara default hanya mengirim payload final. Untuk juga mengirim pesan Thinking terpisah (jika tersedia), atur agents.defaults.heartbeat.includeReasoning: true atau per agen agents.list[].heartbeat.includeReasoning: true.

UI obrolan web

• Pemilih thinking obrolan web mencerminkan level tersimpan sesi dari penyimpanan/konfigurasi sesi masuk saat halaman dimuat.
• Memilih level lain langsung menulis override sesi melalui sessions.patch; tindakan ini tidak menunggu pengiriman berikutnya dan bukan override sekali pakai thinkingOnce.
• Opsi pertama selalu berupa pilihan untuk menghapus override. Opsi ini menampilkan Inherited: <resolved level>, termasuk Inherited: Off saat thinking yang diwariskan dinonaktifkan.
• Pilihan pemilih eksplisit menggunakan label level langsungnya sambil mempertahankan label penyedia jika ada (misalnya Maximum untuk opsi max yang diberi label oleh penyedia).
• Pemilih menggunakan thinkingLevels yang dikembalikan oleh baris/default sesi Gateway, dengan thinkingOptions dipertahankan sebagai daftar label legacy. UI browser tidak menyimpan daftar regex penyedianya sendiri; Plugin memiliki kumpulan level khusus model.
• /think:<level> tetap berfungsi dan memperbarui level sesi tersimpan yang sama, sehingga arahan obrolan dan pemilih tetap tersinkronisasi.

Profil penyedia

• Plugin penyedia dapat mengekspos resolveThinkingProfile(ctx) untuk menentukan level yang didukung model dan defaultnya.
• Plugin penyedia yang mem-proxy model Claude harus menggunakan kembali resolveClaudeThinkingProfile(modelId) dari openclaw/plugin-sdk/provider-model-shared agar katalog Anthropic langsung dan proxy tetap selaras.
• Setiap level profil memiliki id kanonis tersimpan (off, minimal, low, medium, high, xhigh, adaptive, atau max) dan dapat menyertakan label tampilan. Penyedia biner menggunakan { id: "low", label: "on" }.
• Hook profil menerima fakta katalog gabungan jika tersedia, termasuk reasoning, compat.thinkingFormat, dan compat.supportedReasoningEfforts. Gunakan fakta tersebut untuk mengekspos profil biner atau khusus hanya saat kontrak permintaan yang dikonfigurasi mendukung payload yang cocok.
• Plugin alat yang perlu memvalidasi override thinking eksplisit harus menggunakan api.runtime.agent.resolveThinkingPolicy({ provider, model }) plus api.runtime.agent.normalizeThinkingLevel(...); mereka tidak boleh menyimpan daftar level penyedia/model sendiri.
• Plugin alat dengan akses ke metadata model khusus yang dikonfigurasi dapat meneruskan catalog ke resolveThinkingPolicy agar opt-in compat.supportedReasoningEfforts tercermin dalam validasi sisi plugin.
• Hook legacy yang dipublikasikan (supportsXHighThinking, isBinaryThinking, dan resolveDefaultThinkingLevel) tetap ada sebagai adaptor kompatibilitas, tetapi kumpulan level khusus baru harus menggunakan resolveThinkingProfile.
• Baris/default Gateway mengekspos thinkingLevels, thinkingOptions, dan thinkingDefault agar klien ACP/obrolan merender id dan label profil yang sama dengan yang digunakan validasi runtime.