--- read_when: - Anda mengalami masalah konektivitas/autentikasi dan menginginkan perbaikan terpandu - Anda melakukan pembaruan dan ingin pemeriksaan kewajaran summary: Referensi CLI untuk `openclaw doctor` (pemeriksaan kesehatan + perbaikan terpandu) title: Dokter x-i18n: generated_at: "2026-05-12T08:45:16Z" model: gpt-5.5 provider: openai source_hash: 90050276597a50abcc3638e7b7b50f29ef0682f5da30d33d5dca3ad6117173e0 source_path: cli/doctor.md workflow: 16 --- # `openclaw doctor` Pemeriksaan kesehatan + perbaikan cepat untuk Gateway dan saluran. Terkait: - Pemecahan masalah: [Pemecahan Masalah](/id/gateway/troubleshooting) - Audit keamanan: [Keamanan](/id/gateway/security) ## Contoh ```bash openclaw doctor openclaw doctor --repair openclaw doctor --deep openclaw doctor --repair --non-interactive openclaw doctor --generate-gateway-token ``` Untuk izin khusus saluran, gunakan probe saluran, bukan `doctor`: ```bash openclaw channels capabilities --channel discord --target channel: openclaw channels status --probe ``` Probe kapabilitas Discord yang ditargetkan melaporkan izin saluran efektif milik bot; probe status mengaudit saluran Discord yang dikonfigurasi dan target gabung otomatis suara. ## 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 Catatan: - 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](https://github.com/openclaw/nix-openclaw#quick-start) 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.` 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.` 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.`. - 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..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` Jika sebelumnya Anda menjalankan `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (atau `...PASSWORD`), nilai tersebut menimpa file konfigurasi Anda dan dapat menyebabkan kesalahan "unauthorized" yang persisten. ```bash launchctl getenv OPENCLAW_GATEWAY_TOKEN launchctl getenv OPENCLAW_GATEWAY_PASSWORD launchctl unsetenv OPENCLAW_GATEWAY_TOKEN launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD ``` ## Terkait - [Referensi CLI](/id/cli) - [Gateway doctor](/id/gateway/doctor)