Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw doctor

• Pemecahan masalah: Pemecahan Masalah
• Audit keamanan: Keamanan

​

Contoh

openclaw doctor
openclaw doctor --repair
openclaw doctor --deep
openclaw doctor --repair --non-interactive
openclaw doctor --generate-gateway-token

openclaw channels capabilities --channel discord --target channel:<channel-id>
openclaw channels status --probe

​

Opsi

• --no-workspace-suggestions: nonaktifkan saran memori/pencarian workspace
• --yes: terima default tanpa meminta konfirmasi
• --repair: terapkan perbaikan non-layanan yang direkomendasikan tanpa meminta konfirmasi; instalasi dan penulisan ulang layanan Gateway tetap memerlukan konfirmasi interaktif atau perintah Gateway eksplisit
• --fix: alias untuk --repair
• --force: terapkan perbaikan agresif, termasuk menimpa konfigurasi layanan kustom bila diperlukan
• --non-interactive: jalankan tanpa prompt; hanya migrasi aman dan perbaikan non-layanan
• --generate-gateway-token: buat dan konfigurasi token Gateway
• --deep: pindai layanan sistem untuk instalasi Gateway tambahan dan laporkan handoff restart supervisor Gateway terbaru

• Dalam mode Nix (OPENCLAW_NIX_MODE=1), pemeriksaan doctor hanya-baca tetap berfungsi, tetapi doctor --fix, doctor --repair, doctor --yes, dan doctor --generate-gateway-token dinonaktifkan karena openclaw.json tidak dapat diubah. Edit sumber Nix untuk instalasi ini sebagai gantinya; untuk nix-openclaw, gunakan Mulai Cepat yang mengutamakan agen.
• Prompt interaktif (seperti perbaikan keychain/OAuth) hanya berjalan ketika stdin adalah TTY dan --non-interactive tidak diatur. Eksekusi headless (cron, Telegram, tanpa terminal) akan melewati prompt.
• Performa: eksekusi doctor non-interaktif melewati pemuatan plugin yang eager agar pemeriksaan kesehatan headless tetap cepat. Sesi interaktif tetap memuat plugin sepenuhnya ketika pemeriksaan memerlukan kontribusinya.
• --fix (alias untuk --repair) menulis cadangan ke ~/.openclaw/openclaw.json.bak dan menghapus kunci konfigurasi yang tidak dikenal, sambil mencantumkan setiap penghapusan.
• doctor --fix --non-interactive melaporkan definisi layanan Gateway yang hilang atau usang, tetapi tidak memasang atau menulis ulang definisi tersebut di luar mode perbaikan pembaruan. Jalankan openclaw gateway install untuk layanan yang hilang, atau openclaw gateway install --force ketika Anda memang ingin mengganti launcher.
• Pemeriksaan integritas state kini mendeteksi file transkrip yatim di direktori sesi. Mengarsipkannya sebagai .deleted.<timestamp> memerlukan konfirmasi interaktif; --fix, --yes, dan eksekusi headless membiarkannya tetap di tempat.
• Doctor juga memindai ~/.openclaw/cron/jobs.json (atau cron.store) untuk bentuk job Cron lama dan dapat menulis ulang di tempat sebelum scheduler harus menormalisasi otomatis saat runtime.
• Di Linux, doctor memperingatkan ketika crontab pengguna masih menjalankan ~/.openclaw/bin/ensure-whatsapp.sh lama; skrip tersebut tidak lagi dipelihara dan dapat mencatat outage Gateway WhatsApp palsu ketika cron tidak memiliki lingkungan systemd user-bus.
• Ketika WhatsApp diaktifkan, doctor memeriksa event loop Gateway yang terdegradasi dengan klien openclaw-tui lokal yang masih berjalan. doctor --fix hanya menghentikan klien TUI lokal yang terverifikasi agar balasan WhatsApp tidak mengantre di belakang loop refresh TUI yang basi.
• Doctor menulis ulang ref model openai-codex/* lama menjadi ref kanonis openai/* di model utama, fallback, override heartbeat/subagen/compaction, hook, override model saluran, dan pin rute sesi basi. --fix memindahkan intent Codex ke entri agentRuntime.id: "codex" yang terscoped provider/model, mempertahankan pin auth-profile sesi seperti openai-codex:..., menghapus pin runtime seluruh-agen/sesi yang basi, dan menjaga ref agen OpenAI yang diperbaiki tetap pada routing auth Codex, bukan auth API-key OpenAI langsung.
• Doctor membersihkan state staging dependensi plugin lama yang dibuat oleh versi OpenClaw lama dan menautkan ulang paket host openclaw untuk plugin npm terkelola yang mendeklarasikannya sebagai peer dependency. Doctor juga memperbaiki plugin unduhan yang hilang yang direferensikan oleh konfigurasi, seperti plugins.entries, saluran terkonfigurasi, pengaturan provider/pencarian terkonfigurasi, atau runtime agen terkonfigurasi. Selama pembaruan paket, doctor melewati perbaikan plugin package-manager hingga pertukaran paket selesai; jalankan ulang openclaw doctor --fix setelahnya jika plugin terkonfigurasi masih perlu pemulihan. Jika unduhan gagal, doctor melaporkan kesalahan instalasi dan mempertahankan entri plugin terkonfigurasi untuk upaya perbaikan berikutnya.
• Doctor memperbaiki konfigurasi plugin basi dengan menghapus id plugin yang hilang dari plugins.allow/plugins.deny/plugins.entries, beserta konfigurasi saluran menggantung, target Heartbeat, dan override model saluran yang cocok ketika penemuan plugin sehat.
• Doctor mengarantina konfigurasi plugin yang tidak valid dengan menonaktifkan entri plugins.entries.<id> yang terdampak dan menghapus payload config yang tidak valid. Startup Gateway sudah hanya melewati plugin bermasalah tersebut agar plugin dan saluran lain tetap dapat berjalan.
• Atur OPENCLAW_SERVICE_REPAIR_POLICY=external ketika supervisor lain memiliki siklus hidup Gateway. Doctor tetap melaporkan kesehatan Gateway/layanan dan menerapkan perbaikan non-layanan, tetapi melewati instalasi/start/restart/bootstrap layanan dan pembersihan layanan lama.
• Di Linux, doctor mengabaikan unit systemd mirip-Gateway tambahan yang tidak aktif dan tidak menulis ulang metadata perintah/entrypoint untuk layanan Gateway systemd yang sedang berjalan selama perbaikan. Hentikan layanan terlebih dahulu atau gunakan openclaw gateway install --force ketika Anda memang ingin mengganti launcher aktif.
• Doctor memigrasikan otomatis konfigurasi Talk flat lama (talk.voiceId, talk.modelId, dan yang serupa) ke talk.provider + talk.providers.<provider>.
• Eksekusi doctor --fix berulang tidak lagi melaporkan/menerapkan normalisasi Talk ketika satu-satunya perbedaan adalah urutan kunci objek.
• Doctor menyertakan pemeriksaan kesiapan pencarian memori dan dapat merekomendasikan openclaw configure --section model ketika kredensial embedding hilang.
• Doctor memperingatkan ketika tidak ada pemilik perintah yang dikonfigurasi. Pemilik perintah adalah akun operator manusia yang diizinkan menjalankan perintah khusus pemilik dan menyetujui tindakan berbahaya. Pairing DM hanya memungkinkan seseorang berbicara dengan bot; jika Anda menyetujui pengirim sebelum bootstrap pemilik pertama ada, atur commands.ownerAllowFrom secara eksplisit.
• Doctor memperingatkan ketika agen mode Codex dikonfigurasi dan aset CLI Codex pribadi ada di home Codex milik operator. Peluncuran app-server Codex lokal menggunakan home terisolasi per agen, jadi gunakan openclaw migrate codex --dry-run untuk menginventarisasi aset yang harus dipromosikan secara sengaja.
• Doctor menghapus plugins.entries.codex.config.codexDynamicToolsProfile yang sudah dipensiunkan; app-server Codex selalu mempertahankan tool workspace native Codex tetap native.
• Doctor memperingatkan ketika Skills yang diizinkan untuk agen default tidak tersedia di lingkungan runtime saat ini karena bin, env var, konfigurasi, atau persyaratan OS hilang. doctor --fix dapat menonaktifkan Skills yang tidak tersedia tersebut dengan skills.entries.<skill>.enabled=false; instal/konfigurasi persyaratan yang hilang sebagai gantinya ketika Anda ingin mempertahankan skill tetap aktif.
• Jika mode sandbox diaktifkan tetapi Docker tidak tersedia, doctor melaporkan peringatan bernilai-sinyal tinggi dengan remediasi (install Docker atau openclaw config set agents.defaults.sandbox.mode off).
• Jika file registry sandbox lama (~/.openclaw/sandbox/containers.json atau ~/.openclaw/sandbox/browsers.json) ada, doctor melaporkannya; openclaw doctor --fix memigrasikan entri valid ke direktori registry yang dishard dan mengarantina file lama yang tidak valid.
• Jika gateway.auth.token/gateway.auth.password dikelola SecretRef dan tidak tersedia di jalur perintah saat ini, doctor melaporkan peringatan hanya-baca dan tidak menulis kredensial fallback plaintext.
• Jika inspeksi SecretRef saluran gagal dalam jalur perbaikan, doctor melanjutkan dan melaporkan peringatan alih-alih keluar lebih awal.
• Setelah migrasi direktori state, doctor memperingatkan ketika akun Telegram atau Discord default yang diaktifkan bergantung pada fallback env dan TELEGRAM_BOT_TOKEN atau DISCORD_BOT_TOKEN tidak tersedia untuk proses doctor.
• Resolusi otomatis username allowFrom Telegram (doctor --fix) memerlukan token Telegram yang dapat di-resolve di jalur perintah saat ini. Jika inspeksi token tidak tersedia, doctor melaporkan peringatan dan melewati resolusi otomatis untuk pass tersebut.

​

macOS: override env launchctl

launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD

launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD

​

Terkait

• Referensi CLI
• Gateway doctor