Files
openclaw/docs/zh-CN/experiments/onboarding-config-protocol.md
Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build
2026-02-02 16:38:25 +01:00

1.6 KiB
Raw Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
修改新手引导向导步骤或配置 schema 端点时 新手引导向导和配置 schema 的 RPC 协议说明 新手引导与配置协议
generated_at model provider source_hash source_path workflow
2026-02-01T20:24:58Z claude-opus-4-5 pi 55163b3ee029c02476800cb616a054e5adfe97dae5bb72f2763dce0079851e06 experiments/onboarding-config-protocol.md 14

新手引导 + 配置协议

用途:在 CLI、macOS 应用和 Web UI 之间共享新手引导与配置界面。

组件

  • 向导引擎(共享会话 + 提示 + 新手引导状态)。
  • CLI 新手引导使用与 UI 客户端相同的向导流程。
  • Gateway网关 RPC 暴露向导 + 配置 schema 端点。
  • macOS 新手引导使用向导步骤模型。
  • Web UI 根据 JSON Schema + UI 提示渲染配置表单。

Gateway网关 RPC

  • wizard.start 参数:{ mode?: "local"|"remote", workspace?: string }
  • wizard.next 参数:{ sessionId, answer?: { stepId, value? } }
  • wizard.cancel 参数:{ sessionId }
  • wizard.status 参数:{ sessionId }
  • config.schema 参数:{}

响应(结构)

  • 向导:{ sessionId, done, step?, status?, error? }
  • 配置 schema{ schema, uiHints, version, generatedAt }

UI 提示

  • uiHints 按路径作为键可选元数据label/help/group/order/advanced/sensitive/placeholder
  • 敏感字段渲染为密码输入框;无脱敏层。
  • 不支持的 schema 节点回退到原始 JSON 编辑器。

说明

  • 本文档是跟踪新手引导/配置协议重构的唯一位置。