openclaw crestodian

Crestodian adalah pembantu penyiapan lokal, perbaikan, dan konfigurasi OpenClaw. Ia dirancang agar tetap dapat dijangkau ketika jalur agen normal rusak.

Menjalankan openclaw tanpa perintah akan memulai Crestodian di terminal interaktif. Menjalankan openclaw crestodian akan memulai pembantu yang sama secara eksplisit.

Yang Ditampilkan Crestodian

Saat startup, Crestodian interaktif membuka shell TUI yang sama dengan yang digunakan oleh openclaw tui, dengan backend chat Crestodian. Log chat dimulai dengan sapaan singkat:

• kapan memulai Crestodian
• jalur model atau perencana deterministik yang sebenarnya digunakan Crestodian
• validitas config dan agen default
• keterjangkauan Gateway dari probe startup pertama
• tindakan debug berikutnya yang dapat dilakukan Crestodian

Ia tidak menumpahkan rahasia atau memuat perintah CLI Plugin hanya untuk memulai. TUI tetap menyediakan header, log chat, baris status, footer, pelengkapan otomatis, dan kontrol editor normal.

Gunakan status untuk inventaris terperinci dengan jalur config, jalur docs/sumber, probe CLI lokal, keberadaan kunci API, agen, model, dan detail Gateway.

Crestodian menggunakan penemuan referensi OpenClaw yang sama seperti agen biasa. Dalam checkout Git, ia mengarahkan dirinya ke docs/ lokal dan pohon sumber lokal. Dalam instalasi paket npm, ia menggunakan docs paket yang dibundel dan menautkan ke https://github.com/openclaw/openclaw, dengan panduan eksplisit untuk meninjau sumber ketika docs tidak mencukupi.

Contoh

openclawopenclaw crestodianopenclaw crestodian --jsonopenclaw crestodian --message "models"openclaw crestodian --message "validate config"openclaw crestodian --message "setup workspace ~/Projects/work model openai/gpt-5.5" --yesopenclaw crestodian --message "set default model openai/gpt-5.5" --yesopenclaw onboard --modern

Di dalam TUI Crestodian:

statushealthdoctordoctor fixvalidate configsetupsetup workspace ~/Projects/work model openai/gpt-5.5config set gateway.port 19001config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKENgateway statusrestart gatewayagentscreate agent work workspace ~/Projects/workmodelsset default model openai/gpt-5.5plugins listplugins search slackplugin install clawhub:openclaw-codex-app-serverplugin uninstall openclaw-codex-app-servertalk to work agenttalk to agent for ~/Projects/workauditquit

Startup Aman

Jalur startup Crestodian sengaja dibuat kecil. Ia dapat berjalan ketika:

• openclaw.json tidak ada
• openclaw.json tidak valid
• Gateway sedang mati
• pendaftaran perintah Plugin tidak tersedia
• belum ada agen yang dikonfigurasi

openclaw --help dan openclaw --version tetap menggunakan jalur cepat normal. openclaw noninteraktif keluar dengan pesan singkat alih-alih mencetak bantuan root, karena produk tanpa perintah adalah Crestodian.

Operasi dan Persetujuan

Crestodian menggunakan operasi bertipe, bukan mengedit config secara ad hoc.

Operasi hanya-baca dapat berjalan segera:

• menampilkan ringkasan
• mencantumkan agen
• mencantumkan Plugin yang terpasang
• mencari Plugin ClawHub
• menampilkan status model/backend
• menjalankan pemeriksaan status atau kesehatan
• memeriksa keterjangkauan Gateway
• menjalankan doctor tanpa perbaikan interaktif
• memvalidasi config
• menampilkan jalur log audit

Operasi persisten memerlukan persetujuan percakapan dalam mode interaktif kecuali Anda meneruskan --yes untuk perintah langsung:

• menulis config
• menjalankan config set
• mengatur nilai SecretRef yang didukung melalui config set-ref
• menjalankan bootstrap penyiapan/onboarding
• mengubah model default
• memulai, menghentikan, atau memulai ulang Gateway
• membuat agen
• memasang Plugin dari ClawHub atau npm
• menghapus pemasangan Plugin
• menjalankan perbaikan doctor yang menulis ulang config atau state

Penulisan yang diterapkan dicatat di:

~/.openclaw/audit/crestodian.jsonl

Penemuan tidak diaudit. Hanya operasi dan penulisan yang diterapkan yang dicatat.

openclaw onboard --modern memulai Crestodian sebagai pratinjau onboarding modern. openclaw onboard biasa tetap menjalankan onboarding klasik.

Bootstrap Penyiapan

setup adalah bootstrap onboarding yang mengutamakan chat. Ia menulis hanya melalui operasi config bertipe dan meminta persetujuan terlebih dahulu.

setupsetup workspace ~/Projects/worksetup workspace ~/Projects/work model openai/gpt-5.5

Ketika tidak ada model yang dikonfigurasi, setup memilih backend pertama yang dapat digunakan dalam urutan ini dan memberi tahu apa yang dipilihnya:

• model eksplisit yang sudah ada, jika sudah dikonfigurasi
• OPENAI_API_KEY -> openai/gpt-5.5
• ANTHROPIC_API_KEY -> anthropic/claude-opus-4-7
• Claude Code CLI -> claude-cli/claude-opus-4-7
• Codex CLI -> codex-cli/gpt-5.5

Jika tidak ada yang tersedia, setup tetap menulis workspace default dan membiarkan model tidak disetel. Pasang atau masuk ke Codex/Claude Code, atau tampilkan OPENAI_API_KEY/ANTHROPIC_API_KEY, lalu jalankan setup lagi.

Perencana Berbantuan Model

Crestodian selalu dimulai dalam mode deterministik. Untuk perintah fuzzy yang tidak dipahami parser deterministik, Crestodian lokal dapat melakukan satu giliran perencana terbatas melalui jalur runtime normal OpenClaw. Ia pertama-tama menggunakan model OpenClaw yang dikonfigurasi. Jika belum ada model terkonfigurasi yang dapat digunakan, ia dapat fallback ke runtime lokal yang sudah ada di mesin:

• Claude Code CLI: claude-cli/claude-opus-4-7
• harness app-server Codex: openai/gpt-5.5
• Codex CLI: codex-cli/gpt-5.5

Perencana berbantuan model tidak dapat memutasi config secara langsung. Ia harus menerjemahkan permintaan menjadi salah satu perintah bertipe milik Crestodian, lalu aturan persetujuan dan audit normal berlaku. Crestodian mencetak model yang digunakannya dan perintah yang ditafsirkan sebelum menjalankan apa pun. Giliran perencana fallback tanpa config bersifat sementara, alat dinonaktifkan jika runtime mendukungnya, dan menggunakan workspace/sesi sementara.

Mode penyelamatan kanal pesan tidak menggunakan perencana berbantuan model. Penyelamatan jarak jauh tetap deterministik sehingga jalur agen normal yang rusak atau disusupi tidak dapat digunakan sebagai editor config.

Beralih ke Agen

Gunakan pemilih bahasa alami untuk keluar dari Crestodian dan membuka TUI normal:

talk to agenttalk to work agentswitch to main agent

openclaw tui, openclaw chat, dan openclaw terminal tetap membuka TUI agen normal secara langsung. Mereka tidak memulai Crestodian.

Setelah beralih ke TUI normal, gunakan /crestodian untuk kembali ke Crestodian. Anda dapat menyertakan permintaan lanjutan:

/crestodian/crestodian restart gateway

Peralihan agen di dalam TUI meninggalkan jejak bahwa /crestodian tersedia.

Mode Penyelamatan Pesan

Mode penyelamatan pesan adalah entrypoint kanal pesan untuk Crestodian. Ini ditujukan untuk kasus ketika agen normal Anda mati, tetapi kanal tepercaya seperti WhatsApp masih menerima perintah.

Perintah teks yang didukung:

• /crestodian <request>

Alur operator:

You, in a trusted owner DM: /crestodian statusOpenClaw: Crestodian rescue mode. Gateway reachable: no. Config valid: no.You: /crestodian restart gatewayOpenClaw: Plan: restart the Gateway. Reply /crestodian yes to apply.You: /crestodian yesOpenClaw: Applied. Audit entry written.

Pembuatan agen juga dapat diantrekan dari prompt lokal atau mode penyelamatan:

create agent work workspace ~/Projects/work model openai/gpt-5.5/crestodian create agent work workspace ~/Projects/work

Mode penyelamatan jarak jauh adalah permukaan admin. Ia harus diperlakukan seperti perbaikan config jarak jauh, bukan seperti chat normal.

Kontrak keamanan untuk penyelamatan jarak jauh:

• Dinonaktifkan ketika sandboxing aktif. Jika agen/sesi berada dalam sandbox, Crestodian harus menolak penyelamatan jarak jauh dan menjelaskan bahwa perbaikan CLI lokal diperlukan.
• State efektif default adalah auto: izinkan penyelamatan jarak jauh hanya dalam operasi YOLO tepercaya, ketika runtime sudah memiliki otoritas lokal tanpa sandbox.
• Memerlukan identitas owner eksplisit. Penyelamatan tidak boleh menerima aturan pengirim wildcard, kebijakan grup terbuka, webhook tanpa autentikasi, atau kanal anonim.
• Hanya DM owner secara default. Penyelamatan grup/kanal memerlukan opt-in eksplisit.
• Pencarian dan daftar Plugin bersifat hanya-baca. Pemasangan Plugin bersifat hanya-lokal secara default karena mengunduh kode yang dapat dieksekusi. Penghapusan pemasangan Plugin dapat diizinkan sebagai operasi perbaikan yang disetujui ketika kebijakan penyelamatan mengizinkan penulisan persisten.
• Penyelamatan jarak jauh tidak dapat membuka TUI lokal atau beralih ke sesi agen interaktif. Gunakan openclaw lokal untuk handoff agen.
• Penulisan persisten tetap memerlukan persetujuan, bahkan dalam mode penyelamatan.
• Audit setiap operasi penyelamatan yang diterapkan. Penyelamatan kanal pesan mencatat metadata kanal, akun, pengirim, dan alamat sumber. Operasi yang memutasi config juga mencatat hash config sebelum dan sesudah.
• Jangan pernah menggemakan rahasia. Inspeksi SecretRef harus melaporkan ketersediaan, bukan nilai.
• Jika Gateway hidup, utamakan operasi bertipe Gateway. Jika Gateway mati, gunakan hanya permukaan perbaikan lokal minimal yang tidak bergantung pada loop agen normal.

Bentuk config:

{  "crestodian": {    "rescue": {      "enabled": "auto",      "ownerDmOnly": true,    },  },}

enabled harus menerima:

• "auto": default. Izinkan hanya ketika runtime efektif adalah YOLO dan sandboxing mati.
• false: jangan pernah izinkan penyelamatan kanal pesan.
• true: izinkan penyelamatan secara eksplisit ketika pemeriksaan owner/kanal lolos. Ini tetap tidak boleh melewati penolakan sandboxing.

Postur YOLO "auto" default adalah:

• mode sandbox terurai menjadi off
• tools.exec.security terurai menjadi full
• tools.exec.ask terurai menjadi off

Penyelamatan jarak jauh dicakup oleh lane Docker:

pnpm test:docker:crestodian-rescue

Fallback perencana lokal tanpa config dicakup oleh:

pnpm test:docker:crestodian-planner

Smoke permukaan perintah kanal live opt-in memeriksa /crestodian status ditambah roundtrip persetujuan persisten melalui handler penyelamatan:

pnpm test:live:crestodian-rescue-channel

Penyiapan baru tanpa config melalui Crestodian dicakup oleh:

pnpm test:docker:crestodian-first-run

Lane itu dimulai dengan direktori state kosong, merutekan openclaw polos ke Crestodian, menyetel model default, membuat agen tambahan, mengonfigurasi Discord melalui pengaktifan Plugin ditambah token SecretRef, memvalidasi config, dan memeriksa log audit. QA Lab juga memiliki skenario berbasis repo untuk alur Ring 0 yang sama:

pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

Terkait

• Referensi CLI
• Doctor
• TUI
• Sandbox
• Keamanan