openclaw crestodian
Crestodian 是 OpenClaw 的本地设置、修复和配置助手。当正常智能体路径损坏时，它仍然可用：在 openclaw.json 缺失或无效、Gateway 网关宕机、插件命令注册不可用，或尚未配置智能体时，它仍可运行。
启动时机
运行不带子命令的openclaw 会根据配置状态进行路由：
- 配置缺失，或配置存在但没有用户编写的设置（为空，或只有
$schema/meta键）：启动经典新手引导。 - 配置存在但验证失败：启动 Crestodian。
- 配置存在且有效：打开正常的智能体 TUI（连接到可访问的已配置 Gateway 网关；如果没有可访问的 Gateway 网关，则在本地打开）。在 TUI 内使用
/crestodian，或直接运行openclaw crestodian，即可进入 Crestodian。
openclaw crestodian 始终会显式启动 Crestodian，无论配置状态如何。openclaw --help 和 openclaw --version 保持正常的快速路径。
非交互式的裸 openclaw（无 TTY）会以一条短消息退出，而不是打印根帮助：在全新安装时指向非交互式新手引导；配置无效时指向 openclaw crestodian --message "status"；配置有效时指向 openclaw agent --local ...。
openclaw onboard --modern 会以现代新手引导预览的形式启动 Crestodian。普通 openclaw onboard 保持经典新手引导。
Crestodian 显示内容
交互式 Crestodian 会打开与openclaw tui 相同的 TUI shell，并使用 Crestodian 聊天后端。启动问候会涵盖：
- 配置有效性和默认智能体
- Crestodian 正在使用的模型或确定性规划器路径
- 首次启动探测得到的 Gateway 网关可达性
- 下一步推荐的调试操作
status 查看详细清单：配置路径、文档/源代码路径、本地 CLI 探测、密钥/令牌是否存在、智能体、模型和 Gateway 网关详情。
Crestodian 使用与常规智能体相同的参考发现机制：在 Git checkout 中，它会指向本地 docs/ 和源代码树；在 npm 安装中，它会使用内置文档并链接到 https://github.com/openclaw/openclaw，并在文档不足时提示检查源代码。
示例
操作和审批
Crestodian 使用带类型的操作，而不是临时编辑配置。 只读操作会立即运行：显示概览、列出智能体、列出已安装插件、搜索 ClawHub 插件、显示模型/后端状态、运行状态/健康检查、检查 Gateway 网关可达性、运行不带交互式修复的 Doctor、验证配置、显示审计日志路径。启动引导式渠道设置（connect telegram）也会立即运行，向导本身会收集明确答案，并且只在最后提交。
持久化操作需要对话式审批（或对直接命令使用 --yes）：写入配置、config set、config set-ref、设置/新手引导引导流程、更改默认模型、启动/停止/重启 Gateway 网关、创建智能体、安装或卸载插件、运行会重写配置或状态的 Doctor 修复。
审批可以用你自己的话给出：明确回复（“yes”、“sure”、“go ahead”、“not now”）会从封闭的确定性列表中解析，其他任何内容都会由一次独立的宿主运行模型调用判断，该调用只会看到你的消息和待处理提案，绝不会由对话模型自身判断，因为它不能自我批准。含糊回复会让提案保持待处理状态，并让对话再次询问。当没有可用模型时，只适用封闭的确定性列表。
已应用的写入会记录到 ~/.openclaw/audit/crestodian.jsonl。发现过程不会被审计；只有已应用的操作和写入会被审计。
当宿主支持遮罩输入时，渠道设置可以作为托管对话运行。本地 Crestodian TUI 不接受敏感向导答案；它会改为引导你使用 openclaw channels add --channel <channel>，该命令的交互式提示会遮罩凭据。
设置引导流程
setup 是聊天优先的新手引导引导流程。它只通过带类型的配置操作写入，并且会先请求审批。
- 现有显式模型（如果已经配置）。
OPENAI_API_KEY->openai/gpt-5.5ANTHROPIC_API_KEY->anthropic/claude-opus-4-8- Claude Code CLI ->
claude-cli/claude-opus-4-8 - Codex -> 通过 Codex app-server harness 使用
openai/gpt-5.5 - Gemini CLI ->
google-gemini-cli/gemini-3.1-pro-preview
OPENAI_API_KEY/ANTHROPIC_API_KEY，然后再次运行设置。
macOS 应用通过 crestodian.setup.detect 和 crestodian.setup.activate 网关方法驱动同一套阶梯：detect 会列出它找到的每个可复用后端，activate 会对一个候选项进行实时测试（一次真正的“reply with OK”补全），并且只在测试通过后持久化模型、工作区和网关默认值。失败的候选项绝不会更改配置；应用会自动沿阶梯向下尝试，最后提供一个手动密钥/令牌步骤，其内容来自 Gateway 网关当前激活的文本推理提供商插件。所选提供商拥有它的起始模型和配置，并且凭据会以相同方式验证后再保存。
AI 对话
交互式 Crestodian 仅使用 AI：每条消息，包括看起来像键入命令的消息，都会经过与常规 OpenClaw 智能体相同的嵌入式智能体循环，并限制为一个 ring-zerocrestodian 工具，该工具封装带类型的操作。读取操作可自由运行，变更需要你针对该确切操作进行对话式审批（见“操作和审批”），每次已应用写入都会被审计并重新验证。智能体会话会持久化，因此 custodian 具备真正的多轮记忆。它首先使用已配置的 OpenClaw 模型；如果没有可用模型，则按设置阶梯顺序回退到机器上已有的本地运行时：
- Claude Code CLI：
claude-cli/claude-opus-4-8（智能体循环；ring-zero 工具通过 MCP 提供，见下方信任模型） - Codex app-server harness：
openai/gpt-5.5（带强制单工具允许列表的智能体循环） - Gemini CLI：
google-gemini-cli/gemini-3.1-pro-preview（智能体循环；ring-zero 工具通过 MCP 提供）
config set 绝不会到达模型。它会在确定性路径上运行，提案会被遮罩，并且该值会在 AI 可见历史中被遮罩。对于密钥，优先使用 config set-ref <path> env <ENV_VAR>。
消息渠道救援模式绝不会使用模型辅助规划器。远程救援保持确定性，因此损坏或被攻破的正常智能体路径不能被用作配置编辑器。
CLI harness 信任模型
嵌入式运行时和 Codex app-server harness 会直接强制执行 ring-zero 限制：运行携带一个仅包含crestodian 工具的工具允许列表。CLI harness（Claude Code、Gemini CLI）无法强制执行 OpenClaw 工具允许列表，因为 CLI 拥有它自己的原生工具和权限策略，所以如果被要求限制某个工具，OpenClaw 会失败关闭。对于 CLI-harness 模型，Crestodian 会改为：
- 注入一个专用 MCP 服务器，该服务器只提供
crestodian工具，并在本次运行中替换 OpenClaw 的正常 MCP 工具表面（对于 Claude Code，生成的配置会通过--strict-mcp-config应用，因此不会加载其他 MCP 服务器）， - 将每次配置变更都保留在该工具的审批和审计契约内：读取可自由运行，写入需要你的对话式同意，并且每次已应用写入都会被审计并重新验证，
- 将原生工具（文件读取、shell）留给 harness。它们遵循与此机器上正常 OpenClaw 智能体运行相同的权限姿态：使用 OpenClaw 默认 exec 设置时，Claude Code 会绕过权限运行；受限的
tools.exec配置会回退到 CLI 自身的权限策略。
切换到智能体
使用自然语言选择器离开 Crestodian 并打开正常 TUI：openclaw tui、openclaw chat 和 openclaw terminal 会直接打开正常智能体 TUI；它们不会启动 Crestodian。切换到正常 TUI 后，/crestodian 会返回 Crestodian，并且可以选择附带后续请求：
消息救援模式
消息救援模式是 Crestodian 的消息渠道入口点：当你的正常智能体已失效，但可信渠道（例如 WhatsApp）仍能接收命令时使用它。 支持的命令：/crestodian <request>。救援只接受精确的带类型命令语法；自然语言会被拒绝并给出提示，绝不会被猜测为操作，也绝不会咨询模型。
- 当智能体/会话启用沙箱隔离时禁用；Crestodian 会拒绝远程救援，并指向本地 CLI 修复。
- 默认有效状态为
auto：仅在受信任的 YOLO 操作中允许远程救援，此时运行时已经具备未沙箱隔离的本地权限（tools.exec.security解析为full，tools.exec.ask解析为off，且沙箱模式为off）。 - 需要显式的所有者身份；不允许通配符发送者规则、开放群组策略、未经身份验证的 Webhooks 或匿名渠道。
- 默认仅允许所有者私信；群组/渠道救援需要显式选择启用。
- 插件搜索和列表是只读的。插件安装始终只能在本地执行（在救援中被阻止，即使其他方面已启用），因为它会下载可执行代码。插件卸载可以作为持久救援操作批准。
- 远程救援无法打开本地 TUI，也无法切换到交互式智能体会话；使用本地
openclaw进行智能体交接。 - 即使在救援模式下，持久写入仍然需要审批。
- 每个已应用的救援操作都会被审计。消息渠道救援会记录渠道、账号、发送者和源地址元数据；修改配置的操作还会记录修改前后的配置哈希。
- 绝不会回显密钥。SecretRef 检查报告可用性，而不是值。
- 如果 Gateway 网关存活，救援会优先使用 Gateway 网关类型化操作；如果它已停止，救援只使用不依赖正常智能体循环的最小本地修复表面。
enabled："auto"（默认）仅在有效运行时为 YOLO 且沙箱隔离关闭时允许救援；false永不允许消息渠道救援；true在所有者/渠道检查通过时显式允许救援（仍受沙箱隔离拒绝约束）。ownerDmOnly：将救援限制为所有者私信。默认值为true。pendingTtlMinutes：待处理救援写入在过期前保持开放、等待/crestodian yes审批的时长。默认值为15。
/crestodian status，并通过救援处理器完成一次持久审批往返：