Skip to main content

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 是 OpenClaw 的本機設定、修復與組態輔助工具。它設計成在一般 agent 路徑損壞時仍可觸及。 不帶命令執行 openclaw 會在互動式終端機中啟動 Crestodian。執行 openclaw crestodian 則會明確啟動同一個輔助工具。

​
Crestodian 顯示的內容

啟動時，互動式 Crestodian 會開啟與 openclaw tui 相同的 TUI shell，並使用 Crestodian 聊天後端。聊天記錄會以簡短問候開始：
  • 何時啟動 Crestodian
  • Crestodian 實際使用的模型或確定性規劃器路徑
  • 組態有效性與預設 agent
  • 來自首次啟動探測的 Gateway 可達性
  • Crestodian 可採取的下一個除錯動作
它不會傾印秘密，也不會為了啟動而載入 Plugin CLI 命令。TUI 仍提供一般的標頭、聊天記錄、狀態列、頁尾、自動完成與編輯器控制。 使用 status 取得詳細清單，其中包含組態路徑、文件/原始碼路徑、本機 CLI 探測、API 金鑰存在狀態、agents、模型與 Gateway 詳細資料。 Crestodian 使用與一般 agents 相同的 OpenClaw 參考探索。在 Git checkout 中，它會指向本機 docs/ 與本機原始碼樹。在 npm package 安裝中，它會使用隨附的 package 文件並連結至 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
talk to work agent
talk to agent for ~/Projects/work
audit
quit

​
安全啟動

Crestodian 的啟動路徑刻意保持精簡。它可以在下列情況下執行：
  • 缺少 openclaw.json
  • openclaw.json 無效
  • Gateway 已關閉
  • Plugin 命令註冊無法使用
  • 尚未設定任何 agent
openclaw --help 與 openclaw --version 仍使用一般快速路徑。非互動式 openclaw 會以簡短訊息結束，而不是列印根 help，因為無命令產品是 Crestodian。

​
操作與核准

Crestodian 使用具型別的操作，而不是臨時編輯組態。 唯讀操作可以立即執行：
  • 顯示概覽
  • 列出 agents
  • 顯示模型/後端狀態
  • 執行狀態或健康檢查
  • 檢查 Gateway 可達性
  • 執行 doctor 但不進行互動式修復
  • 驗證組態
  • 顯示稽核記錄路徑
持久性操作在互動式模式中需要對話式核准，除非你為直接命令傳入 --yes：
  • 寫入組態
  • 執行 config set
  • 透過 config set-ref 設定支援的 SecretRef 值
  • 執行設定/入門 bootstrap
  • 變更預設模型
  • 啟動、停止或重新啟動 Gateway
  • 建立 agents
  • 執行會重寫組態或狀態的 doctor 修復
已套用的寫入會記錄於： 
~/.openclaw/audit/crestodian.jsonl
探索不會被稽核。只有已套用的操作與寫入會被記錄。 openclaw onboard --modern 會以現代入門預覽啟動 Crestodian。純 openclaw onboard 仍會執行傳統入門流程。

​
設定 bootstrap

setup 是聊天優先的入門 bootstrap。它只會透過具型別的組態操作寫入，並且會先要求核准。 
setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
未設定模型時，setup 會依照以下順序選擇第一個可用的後端，並告訴你它選擇了什麼：
  • 既有明確模型，如果已設定
  • 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
如果都無法使用，setup 仍會寫入預設工作區，並讓模型保持未設定。安裝或登入 Codex/Claude Code，或公開 OPENAI_API_KEY/ANTHROPIC_API_KEY，然後再次執行 setup。

​
模型輔助規劃器

Crestodian 一律以確定性模式啟動。對於確定性解析器無法理解的模糊命令，本機 Crestodian 可透過 OpenClaw 的一般執行階段路徑進行一次有界規劃器回合。它會先使用已設定的 OpenClaw 模型。如果尚無可用的已設定模型，它可以 fallback 到機器上已存在的本機執行階段：
  • Claude Code CLI: claude-cli/claude-opus-4-7
  • Codex app-server harness: openai/gpt-5.5 with agentRuntime.id: "codex"
  • Codex CLI: codex-cli/gpt-5.5
模型輔助規劃器無法直接變更組態。它必須將請求轉譯為 Crestodian 的其中一個具型別命令，然後套用一般核准與稽核規則。Crestodian 會在執行任何動作前，列印它使用的模型與解讀出的命令。無組態 fallback 規劃器回合是暫時性的、在執行階段支援時會停用工具，並使用暫時工作區/session。 訊息通道救援模式不使用模型輔助規劃器。遠端救援保持確定性，因此損壞或遭入侵的一般 agent 路徑無法被用作組態編輯器。

​
切換至 agent

使用自然語言選擇器離開 Crestodian 並開啟一般 TUI： 
talk to agent
talk to work agent
switch to main agent
openclaw tui、openclaw chat 與 openclaw terminal 仍會直接開啟一般 agent TUI。它們不會啟動 Crestodian。 切換到一般 TUI 後，使用 /crestodian 返回 Crestodian。你可以包含後續請求： 
/crestodian
/crestodian restart gateway
TUI 內的 agent 切換會留下麵包屑，指出 /crestodian 可用。

​
訊息救援模式

訊息救援模式是 Crestodian 的訊息通道進入點。它適用於你的正常 agent 已停止運作，但 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.
也可以從本機提示或救援模式佇列建立 agent： 
create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work
遠端救援模式是管理介面。它必須被視為遠端組態修復，而不是一般聊天。 遠端救援的安全合約：
  • 沙箱化啟用時停用。如果 agent/session 已被沙箱化，Crestodian 必須拒絕遠端救援，並說明需要本機 CLI 修復。
  • 預設有效狀態是 auto：只在受信任的 YOLO 操作中允許遠端救援，此時執行階段已具有未沙箱化的本機權限。
  • 要求明確的 owner 身分。救援不得接受萬用字元寄件者規則、開放群組政策、未驗證的 webhooks 或匿名通道。
  • 預設僅限 owner DM。群組/通道救援需要明確 opt-in。
  • 遠端救援無法開啟本機 TUI，也無法切換到互動式 agent session。使用本機 openclaw 進行 agent handoff。
  • 即使在救援模式中，持久性寫入仍需要核准。
  • 稽核每個已套用的救援操作。訊息通道救援會記錄通道、帳號、寄件者與來源位址中繼資料。會變更組態的操作也會記錄變更前後的組態雜湊。
  • 絕不回顯秘密。SecretRef 檢查應回報可用性，而不是值。
  • 如果 Gateway 存活，優先使用 Gateway 具型別操作。如果 Gateway 已停止，則只使用不依賴一般 agent 迴圈的最小本機修復介面。
組態形狀： 
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
enabled 應接受：
  • "auto"：預設。只在有效執行階段為 YOLO 且沙箱化關閉時允許。
  • false：永不允許訊息通道救援。
  • true：當 owner/通道檢查通過時明確允許救援。這仍不得繞過沙箱化拒絕。
預設 "auto" YOLO 姿態是：
  • sandbox mode 解析為 off
  • tools.exec.security 解析為 full
  • tools.exec.ask 解析為 off
遠端救援由 Docker lane 覆蓋： 
pnpm test:docker:crestodian-rescue
無組態本機規劃器 fallback 由下列項目覆蓋： 
pnpm test:docker:crestodian-planner
Opt-in 即時通道命令介面 smoke 會檢查 /crestodian status，以及透過救援處理器的持久性核准 roundtrip： 
pnpm test:live:crestodian-rescue-channel
透過 Crestodian 進行全新的無組態設定由下列項目覆蓋： 
pnpm test:docker:crestodian-first-run
該 lane 會從空狀態目錄開始，將裸 openclaw 路由至 Crestodian，設定預設模型、建立額外 agent、透過 Plugin enablement 加 token SecretRef 設定 Discord、驗證組態，並檢查稽核記錄。QA Lab 也有一個 repo-backed scenario，用於相同的 Ring 0 流程： 
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

​
相關