24 - OpenClaw 能力拓展平台

固定顺序模板：流程图 1 -> 流程图 2 -> 时序图（可选）-> 流程总结。扩展内容仅允许后置追加。

🔄 能力资产上架

flowchart LR draft[Draft] --> submit[SubmitReview] submit --> review{ReviewOk} review -->|yes| published[Published] review -->|no| draft published --> deprecate[Deprecated]

流程说明

ISV 或运营创建草稿，提交评审；通过后版本进入 published，可被授权；deprecated 表示下架不再新发授权。

📋 交付包到 OpenClaw 工作区

flowchart TD ent[EntitlementOk] --> pack[BuildBundle] pack --> sign[SignOptional] sign --> dl[TenantDownload] dl --> merge[UserMergeInWorkspace] merge --> ack[SyncAckAudit]

流程说明

平台生成 DeliveryBundle（清单 + 文件 + 校验和）；用户在 OpenClaw 工作区手动或脚本合并；回写 ack 记入审计。平台不远程执行 MCP。

⏱️ 混合搜索

sequenceDiagram participant U as TenantUser participant API as MidwayAPI participant FTS as FullTextIndex participant VEC as VectorStore participant DB as MySQL U->>API: search q keyword vector flag API->>FTS: keyword query API->>VEC: optional embedding query FTS-->>API: keyword hits VEC-->>API: semantic hits API->>DB: insert search_audit API-->>U: merged ranked list

时序说明

租户隔离贯穿存储与查询；PII 与密钥不得进入向量索引；search_audit 记录延迟与命中规模。

🌐 能力发现与安装（行业常见链路 · 对照参考）

flowchart TD disc[发现: 市场/目录/搜索] --> lic[许可证与风险披露] lic --> ent[租户授权 Entitlement] ent --> get[拉取包/清单] get --> pin[版本固定与校验] pin --> merge[合并至 OpenClaw 工作区] merge --> audit[审计与回滚预案]

说明

公开资料中常见「目录发现 → 一键安装 → 热更新」等体验（如社区讨论的 Skills / MCP 市场形态），本项目 MVP 以授权 + 签名校验 + 用户侧合并为硬闸门；不承诺在平台进程内代执行第三方 MCP。具体数字与 SLA 以合同与验收为准，不绑定外部宣传口径。

🤖 Agent 发布 / 订阅（API + 人审闸门）

sequenceDiagram participant A as OpenClaw Agent participant U as UploadInit participant P as PublishAPI participant R as ReviewQueue participant S as SubscribeAPI participant E as Entitlement A->>U: upload/init U-->>A: presigned URL A->>P: skill/publish(uploadId, manifest) alt 需人审 P->>R: pending R-->>P: approved end A->>S: skill/subscribe(slot, version) S->>E: bind E-->>A: ok

说明

与人类 ISV 共用评审与 Entitlement 模型；Agent 凭证独立、低默认权限。详见 skills_distribution.md。

⛓️ 贡献点批次结算（Merkle 批次 · 非链）

flowchart LR E[Ledger 事件追加] --> B[待结算池] B -->|滚批| M[MerkleRoot] M --> C[关账 batchClose] C --> F[冻结批次]

说明

借鉴「出块 / 默克尔根 / 确认」隐喻做对账与审计；CP 非法币。法币与合同仍以支付通道为准。

📝 流程总结

核心链路：资产版本化 → 租户授权 → 签名包交付 → 用户侧合并；搜索为独立横切能力；扩展：多身份 Web 页面、Agent 交换、贡献点批次结算（见 skills_distribution.md）。与 21 号工程分工：宿主初始化在 21，商业能力与计费在本项目。

← 返回文档总览

24 - OpenClaw 能力拓展平台 - 交互流程地图

流程说明

流程说明

时序说明

说明

说明

说明