Langsung ke konten utama

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 crestodian

Crestodian adalah helper penyiapan, perbaikan, dan konfigurasi lokal OpenClaw. Ini dirancang agar tetap dapat dijangkau saat jalur agen normal rusak. Menjalankan openclaw tanpa perintah memulai Crestodian di terminal interaktif. Menjalankan openclaw crestodian memulai helper yang sama secara eksplisit.

​
Yang ditampilkan Crestodian

Saat startup, Crestodian interaktif membuka shell TUI yang sama seperti yang digunakan oleh openclaw tui, dengan backend chat Crestodian. Log chat dimulai dengan sapaan singkat:
  • kapan harus memulai Crestodian
  • model atau jalur perencana deterministik yang benar-benar digunakan Crestodian
  • validitas konfigurasi dan agen default
  • keterjangkauan Gateway dari probe startup pertama
  • tindakan debug berikutnya yang dapat dilakukan Crestodian
Ini tidak membuang secret atau memuat perintah CLI plugin hanya untuk memulai. TUI tetap menyediakan header, log chat, baris status, footer, autocomplete, dan kontrol editor normal. Gunakan status untuk inventaris terperinci dengan jalur konfigurasi, jalur docs/source, probe CLI lokal, keberadaan kunci API, agen, model, dan detail Gateway. Crestodian menggunakan penemuan referensi OpenClaw yang sama seperti agen reguler. Dalam checkout Git, ini mengarahkan dirinya ke docs/ lokal dan pohon sumber lokal. Dalam instalasi paket npm, ini menggunakan dokumentasi paket bawaan dan menautkan ke https://github.com/openclaw/openclaw, dengan panduan eksplisit untuk meninjau sumber setiap kali dokumentasi tidak cukup.

​
Contoh

openclaw
openclaw crestodian
openclaw crestodian --json
openclaw crestodian --message "models"
openclaw crestodian --message "validate config"
openclaw crestodian --message "setup workspace ~/Projects/work model openai/gpt-5.5" --yes
openclaw crestodian --message "set default model openai/gpt-5.5" --yes
openclaw onboard --modern
Di dalam TUI Crestodian: 
status
health
doctor
doctor fix
validate config
setup
setup workspace ~/Projects/work model openai/gpt-5.5
config set gateway.port 19001
config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKEN
gateway status
restart gateway
agents
create agent work workspace ~/Projects/work
models
set default model openai/gpt-5.5
plugins list
plugins search slack
plugin install clawhub:openclaw-codex-app-server
plugin uninstall openclaw-codex-app-server
talk to work agent
talk to agent for ~/Projects/work
audit
quit

​
Startup aman

Jalur startup Crestodian sengaja dibuat kecil. Ini dapat berjalan saat:
  • openclaw.json tidak ada
  • openclaw.json tidak valid
  • Gateway sedang down
  • 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 alih-alih mengedit konfigurasi secara ad hoc. Operasi baca-saja dapat langsung berjalan:
  • tampilkan ringkasan
  • daftar agen
  • daftar plugin terinstal
  • cari plugin ClawHub
  • tampilkan status model/backend
  • jalankan pemeriksaan status atau kesehatan
  • periksa keterjangkauan Gateway
  • jalankan doctor tanpa perbaikan interaktif
  • validasi konfigurasi
  • tampilkan jalur log audit
Operasi persisten memerlukan persetujuan percakapan dalam mode interaktif kecuali Anda meneruskan --yes untuk perintah langsung:
  • tulis konfigurasi
  • jalankan config set
  • atur nilai SecretRef yang didukung melalui config set-ref
  • jalankan bootstrap penyiapan/onboarding
  • ubah model default
  • mulai, hentikan, atau mulai ulang Gateway
  • buat agen
  • instal plugin dari ClawHub atau npm
  • hapus instalasi plugin
  • jalankan perbaikan doctor yang menulis ulang konfigurasi atau status
Penulisan yang diterapkan direkam 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. Ini menulis hanya melalui operasi konfigurasi bertipe dan meminta persetujuan terlebih dahulu. 
setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
Saat tidak ada model yang dikonfigurasi, penyiapan memilih backend pertama yang dapat digunakan dalam urutan ini dan memberi tahu Anda apa yang dipilih:
  • 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, penyiapan tetap menulis workspace default dan membiarkan model belum disetel. Instal atau masuk ke Codex/Claude Code, atau ekspos OPENAI_API_KEY/ANTHROPIC_API_KEY, lalu jalankan penyiapan lagi.

​
Perencana Berbantuan Model

Crestodian selalu dimulai dalam mode deterministik. Untuk perintah fuzzy yang tidak dipahami parser deterministik, Crestodian lokal dapat membuat satu giliran perencana terbatas melalui jalur runtime normal OpenClaw. Ini pertama-tama menggunakan model OpenClaw yang dikonfigurasi. Jika belum ada model terkonfigurasi yang dapat digunakan, ini 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 dengan agentRuntime.id: "codex"
  • Codex CLI: codex-cli/gpt-5.5
Perencana berbantuan model tidak dapat memutasi konfigurasi secara langsung. Ia harus menerjemahkan permintaan menjadi salah satu perintah bertipe Crestodian, lalu aturan persetujuan dan audit normal berlaku. Crestodian mencetak model yang digunakan dan perintah yang diinterpretasikan sebelum menjalankan apa pun. Giliran perencana fallback tanpa konfigurasi bersifat sementara, tanpa tool jika runtime mendukungnya, dan menggunakan workspace/sesi sementara. Mode penyelamatan kanal pesan tidak menggunakan perencana berbantuan model. Penyelamatan jarak jauh tetap deterministik agar jalur agen normal yang rusak atau terkompromi tidak dapat digunakan sebagai editor konfigurasi.

​
Beralih ke agen

Gunakan selector bahasa alami untuk meninggalkan Crestodian dan membuka TUI normal: 
talk to agent
talk to work agent
switch 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 breadcrumb bahwa /crestodian tersedia.

​
Mode penyelamatan pesan

Mode penyelamatan pesan adalah entrypoint kanal pesan untuk Crestodian. Ini 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 status
OpenClaw: Crestodian rescue mode. Gateway reachable: no. Config valid: no.
You: /crestodian restart gateway
OpenClaw: Plan: restart the Gateway. Reply /crestodian yes to apply.
You: /crestodian yes
OpenClaw: 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. Ini harus diperlakukan seperti perbaikan konfigurasi jarak jauh, bukan seperti chat normal. Kontrak keamanan untuk penyelamatan jarak jauh:
  • Dinonaktifkan saat sandboxing aktif. Jika agen/sesi disandbox, Crestodian harus menolak penyelamatan jarak jauh dan menjelaskan bahwa perbaikan CLI lokal diperlukan.
  • Status efektif default adalah auto: izinkan penyelamatan jarak jauh hanya dalam operasi YOLO tepercaya, saat 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.
  • DM owner saja secara default. Penyelamatan grup/kanal memerlukan opt-in eksplisit.
  • Pencarian dan daftar plugin bersifat baca-saja. Instalasi plugin bersifat lokal-saja secara default karena mengunduh kode yang dapat dieksekusi. Penghapusan instalasi plugin dapat diizinkan sebagai operasi perbaikan yang disetujui saat 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 merekam metadata kanal, akun, pengirim, dan alamat sumber. Operasi yang memutasi konfigurasi juga merekam hash konfigurasi sebelum dan sesudah.
  • Jangan pernah menggemakan secret. Inspeksi SecretRef harus melaporkan ketersediaan, bukan nilai.
  • Jika Gateway hidup, pilih operasi bertipe Gateway. Jika Gateway mati, gunakan hanya permukaan perbaikan lokal minimal yang tidak bergantung pada loop agen normal.
Bentuk konfigurasi: 
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
enabled harus menerima:
  • "auto": default. Izinkan hanya saat runtime efektif adalah YOLO dan sandboxing mati.
  • false: jangan pernah izinkan penyelamatan kanal pesan.
  • true: izinkan penyelamatan secara eksplisit saat pemeriksaan owner/kanal lolos. Ini tetap tidak boleh melewati penolakan sandboxing.
Postur YOLO "auto" default adalah:
  • mode sandbox diselesaikan menjadi off
  • tools.exec.security diselesaikan menjadi full
  • tools.exec.ask diselesaikan menjadi off
Penyelamatan jarak jauh dicakup oleh lane Docker: 
pnpm test:docker:crestodian-rescue
Fallback perencana lokal tanpa konfigurasi dicakup oleh: 
pnpm test:docker:crestodian-planner
Smoke permukaan perintah kanal live opt-in memeriksa /crestodian status plus roundtrip persetujuan persisten melalui handler penyelamatan: 
pnpm test:live:crestodian-rescue-channel
Penyiapan baru tanpa konfigurasi 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 plus SecretRef token, memvalidasi konfigurasi, 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