> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Crestodian

# `openclaw crestodian`

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

Menjalankan `openclaw` tanpa perintah akan memulai orientasi klasik terlebih dahulu saat
file konfigurasi aktif tidak ada atau tidak memiliki pengaturan yang ditulis (kosong atau
hanya metadata). Setelah file konfigurasi memiliki pengaturan yang ditulis, menjalankan
`openclaw` tanpa perintah akan memulai Crestodian di terminal interaktif. Menjalankan
`openclaw crestodian` memulai pembantu yang sama secara eksplisit.

## Yang Ditampilkan Crestodian

Saat mulai, 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
* 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, pelengkapan otomatis,
dan kontrol editor normal.

Gunakan `status` untuk inventaris terperinci dengan path konfigurasi, path 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 source lokal. Dalam instalasi paket npm, ini
menggunakan docs paket bawaan dan menautkan ke
[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw), dengan panduan eksplisit
untuk meninjau source setiap kali docs tidak cukup.

## Contoh

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` polos noninteraktif keluar dengan pesan singkat alih-alih mencetak
bantuan root. Pada instalasi baru, pesan tersebut mengarah ke orientasi noninteraktif;
setelah penyiapan, pesan tersebut mengarah ke perintah Crestodian sekali jalan.

## 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 path log audit

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

* tulis konfigurasi
* jalankan `config set`
* tetapkan nilai SecretRef yang didukung melalui `config set-ref`
* jalankan bootstrap penyiapan/orientasi
* 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 dicatat di:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.openclaw/audit/crestodian.jsonl
```

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

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

## Bootstrap Penyiapan

`setup` adalah bootstrap orientasi yang mengutamakan chat. Ini hanya menulis melalui operasi
konfigurasi bertipe dan meminta persetujuan terlebih dahulu.

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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-8`
* CLI Claude Code -> `claude-cli/claude-opus-4-8`
* Codex -> `openai/gpt-5.5` melalui harness app-server Codex

Jika tidak ada yang tersedia, penyiapan tetap menulis workspace default dan membiarkan
model tidak ditetapkan. Instal atau masuk ke Codex/Claude Code, atau sediakan
`OPENAI_API_KEY`/`ANTHROPIC_API_KEY`, lalu jalankan penyiapan lagi.

## Perencana Berbantuan Model

Crestodian selalu mulai dalam mode deterministik. Untuk perintah samar yang tidak
dipahami parser deterministik, Crestodian lokal dapat membuat satu giliran perencana
terbatas melalui jalur runtime normal OpenClaw. Ini pertama menggunakan model
OpenClaw yang dikonfigurasi. Jika belum ada model terkonfigurasi yang dapat digunakan, ini dapat
fallback ke runtime lokal yang sudah ada di mesin:

* CLI Claude Code: `claude-cli/claude-opus-4-8`
* harness app-server Codex: `openai/gpt-5.5`

Perencana berbantuan model tidak dapat mengubah konfigurasi secara langsung. Ini harus menerjemahkan
permintaan menjadi salah satu perintah bertipe Crestodian, lalu aturan persetujuan dan
audit normal berlaku. Crestodian mencetak model yang digunakannya dan perintah yang
diinterpretasikan sebelum menjalankan apa pun. Giliran perencana fallback tanpa konfigurasi bersifat
sementara, tool dinonaktifkan jika didukung runtime, 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 disusupi tidak dapat
digunakan sebagai editor konfigurasi.

## Beralih ke Agen

Gunakan pemilih bahasa alami untuk meninggalkan Crestodian dan membuka TUI normal:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/crestodian
/crestodian restart gateway
```

Peralihan agen di dalam TUI meninggalkan penanda bahwa `/crestodian` tersedia.

## Mode Penyelamatan Pesan

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

Perintah teks yang didukung:

* `/crestodian <request>`

Alur operator:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 dimasukkan ke antrean dari prompt lokal atau mode penyelamatan:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 berada dalam sandbox,
  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 hanya lokal 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 mencatat metadata kanal,
  akun, pengirim, dan alamat sumber. Operasi yang mengubah konfigurasi juga
  mencatat hash konfigurasi sebelum dan sesudah.
* Jangan pernah menggemakan secret. 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 konfigurasi:

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
```

`enabled` harus menerima:

* `"auto"`: default. Izinkan hanya saat runtime efektif adalah YOLO dan
  sandboxing nonaktif.
* `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 bernilai `off`
* `tools.exec.security` bernilai `full`
* `tools.exec.ask` bernilai `off`

Penyelamatan jarak jauh dicakup oleh lane Docker:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:crestodian-rescue
```

Fallback perencana lokal tanpa konfigurasi dicakup oleh:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:crestodian-planner
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:live:crestodian-rescue-channel
```

Penyiapan tanpa konfigurasi melalui perintah Crestodian eksplisit dicakup oleh:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:crestodian-first-run
```

Lane tersebut dimulai dengan direktori status kosong, memverifikasi entrypoint Crestodian
orientasi modern, menetapkan 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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup
```

## Terkait

* [Referensi CLI](/id/cli)
* [Doctor](/id/cli/doctor)
* [TUI](/id/cli/tui)
* [Sandbox](/id/cli/sandbox)
* [Keamanan](/id/cli/security)