Crestodian

`openclaw crestodian`

Crestodian 是 OpenClaw 的本機設定、修復與配置輔助工具。其設計目的是在一般代理程式路徑損壞時，仍能保持連線。

當作用於配置檔案遺失或沒有使用者設定（空白或僅有元資料）時，執行 openclaw 且不帶任何指令會先啟動經典的入學流程。當配置檔案已有使用者設定後，執行 openclaw 且不帶任何指令會在互動式終端機中啟動 Crestodian。執行 openclaw crestodian 則會明確啟動相同的輔助程式。

Crestodian 顯示的內容

啟動時，互動式 Crestodian 會開啟與 openclaw tui 相同的 TUI shell，並搭配 Crestodian 聊天後端。聊天記錄以簡短的問候語開始：

何時啟動 Crestodian
Crestodian 實際使用的模型或確定性規劃器路徑
配置有效性與預設代理程式
從首次啟動探針測試的 Gateway 連線能力
Crestodian 可採取的下一個除錯動作

它不會僅為了啟動而傾印機密或載入外掛程式 CLI 指令。TUI 仍提供一般的標題、聊天記錄、狀態列、頁尾、自動完成和編輯器控制項。

使用 status 查看包含設定路徑、文件/來源路徑、本機 CLI 探測、API 金鑰狀態、代理程式、模型和 Gateway 詳細資訊的完整庫存。

Crestodian 使用與一般代理程式相同的 OpenClaw 參考探索機制。在 Git 檢出中，它會指向本機的 docs/ 和本機來源樹。在 npm 套件安裝中，它會使用套件內附的文件並連結至 https://github.com/openclaw/openclaw，並明確指引在文件不足時檢閱來源。

範例

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

在 Crestodian TUI 內：

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

安全啟動

Crestodian 的啟動路徑經刻意縮減。它可以在以下情況下執行：

openclaw.json 遺失
openclaw.json 無效
Gateway 停機
外掛程式指令註冊無法使用
尚未設定任何代理程式

openclaw --help 和 openclaw --version 仍使用一般的快速路徑。非互動式的純 openclaw 會顯示簡短訊息後退出，而不是印出根說明。在全新安裝時，該訊息會指向非互動式入學流程；安裝設定後，則指向一次性 Crestodian 指令。

操作與核准

Crestodian 使用具類型操作，而非臨時編輯配置。

唯讀操作可立即執行：

顯示概覽
列出代理程式
列出已安裝的外掛
搜尋 ClawHub 外掛
顯示模型/後端狀態
執行狀態或健康檢查
檢查 Gateway 連通性
執行 doctor 而不進行互動式修復
驗證配置
顯示稽核日誌路徑

在互動模式下，持續性操作需要對話式批准，除非您傳遞 --yes 以直接執行指令：

寫入配置
執行 config set
透過 config set-ref 設定支援的 SecretRef 值
執行設定/入門引導
變更預設模型
啟動、停止或重新啟動 Gateway
建立代理
從 ClawHub 或 npm 安裝外掛
解除安裝外掛
執行會重寫配置或狀態的 doctor 修復

應用的寫入操作記錄於：

~/.openclaw/audit/crestodian.jsonl

發現過程不受稽核。只有已應用的操作和寫入會被記錄。

openclaw onboard --modern 會以現代入學預覽模式啟動 Crestodian。純 openclaw onboard 則仍執行經典入學流程。

設定引導

setup 是以聊天為優先的入學啟動程式。它僅透過類型化的設定操作進行寫入，並會事先請求批准。

setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5

當未配置模型時，設定會按此順序選擇第一個可用的後端，並告訴您它的選擇：

現有的明確模型（如果已配置）
OPENAI_API_KEY -> openai/gpt-5.5
ANTHROPIC_API_KEY -> anthropic/claude-opus-4-8
Claude Code CLI -> claude-cli/claude-opus-4-8
Codex -> openai/gpt-5.5 透過 Codex app-server harness

如果都無法使用，安裝程式仍會寫入預設工作區並保持模型未設定。請安裝或登入 Codex/Claude Code，或暴露 OPENAI_API_KEY/ANTHROPIC_API_KEY，然後再次執行安裝程式。

模型輔助規劃器

Crestodian 始終以確定性模式啟動。對於確定性解析器無法理解的模糊指令，本機 Crestodian 可以透過 OpenClaw 的正常執行路徑進行一次有限的規劃器運轉。它首先使用已設定的 OpenClaw 模型。如果尚未有可用的已設定模型，它可以回退到機器上已存在的本機執行環境：

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

模型輔助規劃器無法直接修改配置。它必須將請求轉換為 Crestodian 的類型化指令之一，然後適用正常的審批和稽核規則。Crestodian 在執行任何操作之前會列印它使用的模型和解釋後的指令。無配置後備規劃器的輪次是臨時的，在執行時支援的情況下會停用工具，並使用臨時工作區/工作階段。

訊息通道救援模式不使用模型輔助規劃器。遠端救援保持確定性，因此損壞或被洩露的常規代理路徑無法被用作配置編輯器。

切換到代理

使用自然語言選擇器離開 Crestodian 並開啟正常的 TUI：

talk to agent
talk to work agent
switch to main agent

openclaw tui、openclaw chat 和 openclaw terminal 仍會直接開啟正常的代理程式 TUI。它們不會啟動 Crestodian。

切換至正常 TUI 後，使用 /crestodian 返回 Crestodian。您可以包含後續請求：

/crestodian
/crestodian restart gateway

TUI 內部的代理程式切換會留下麵包屑，表示 /crestodian 可用。

訊息救援模式

訊息救援模式是 Crestodian 的訊息通道入口。它用於常規代理已死機，但諸如 WhatsApp 等受信任通道仍然接收指令的情況。

支援的文字指令：

/crestodian <request>

操作員流程：

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.

代理建立也可以從本地提示或救援模式排入佇列：

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

遠端救援模式是管理介面。必須將其視為遠端配置修復，而不是正常聊天。

遠端救援的安全契約：

啟用沙盒時停用。如果代理/工作階段受到沙盒限制，Crestodian 必須拒絕遠端救援並說明需要進行本地 CLI 修復。
預設有效狀態為 auto：僅在受信任的 YOLO 操作中允許遠端救援，此時執行時期已具有未沙盒化的本機權限。
需要明確的所有者身分。救援不得接受通配符發送者規則、開放群組策略、未經驗證的 Webhook 或匿名通道。
預設情況下僅限所有者私訊（DM）。群組/通道救援需要明確選擇加入。
外掛程式搜尋和清單為唯讀。由於外掛程式安裝會下載可執行程式碼，因此預設僅限本地。當救援策略允許持久寫入時，可將外掛程式解除安裝作為經批准的修復操作。
遠端救援無法開啟本機 TUI 或切換至互動式代理程式會話。請使用本機 openclaw 進行代理程式交接。
即使在救援模式下，持久寫入仍需經過批准。
審計每個已套用的救援操作。訊息通道救援會記錄通道、帳戶、發送者和來源位址元資料。配置變更操作也會記錄變更前後的配置雜湊值。
切勿回顯機密。SecretRef 檢查應回報可用性，而非實際值。
如果 Gateway 存活，優先使用 Gateway 類型的操作。如果 Gateway 已停擺，則僅使用不依賴正常代理程式迴圈的最小本地修復介面。

配置形狀：

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

enabled 應接受：

"auto"：預設值。僅在有效執行時期為 YOLO 且沙盒化關閉時允許。
false：永不允許訊息通道救援。
true：當擁有者/通道檢查通過時明確允許救援。這仍不得繞過沙盒化拒絕。

預設 "auto" YOLO 態勢為：

沙盒模式解析為 off
tools.exec.security 解析為 full
tools.exec.ask 解析為 off

遠端救援涵蓋於 Docker 路徑：

pnpm test:docker:crestodian-rescue

無配置本地規劃器備援涵蓋於：

pnpm test:docker:crestodian-planner

一個選用型的即時通道指令介面煙霧測試 /crestodian status 加上一個透過救援處理程式的持續批准往返：

pnpm test:live:crestodian-rescue-channel

透過明確 Crestodian 指令進行的無設定安裝涵蓋於：

pnpm test:docker:crestodian-first-run

該通道以一個空的狀態目錄開始，驗證現代上線 Crestodian 進入點，設置預設模型，建立一個額外的代理，透過外掛程式啟用加上權杖 SecretRef 來配置 Discord，驗證配置，並檢查稽核日誌。QA Lab 針對相同的 Ring 0 流程也有一個以儲存庫支援的場景：

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