⚡ HTML 生成时间：2026-04-19 11:33:42（源文件更新后需重新转换）
24 - OpenClaw 能力拓展平台 — 技术参考
更新日期：2026-04-19
1. 技术栈（默认）
| 组件 | 选型 | 说明 |
|---|---|---|
| 管理端 | Cool Admin Vue（Vue 3 + Element Plus） | 租户/ISV/运营 |
| 后端 | Cool Admin Midway（Node.js） | REST + 权限 + 计费 |
| 关系库 | MySQL 8 | 业务主存 |
| 缓存 | Redis | 会话、限流、搜索缓存 |
| 搜索引擎 | MySQL FTS（MVP）或 Elasticsearch（可选） | 全文检索 |
| 向量检索 | pgvector / Milvus / 云向量 API（Phase 1.5） | 语义找能力；与业务库解耦 |
不包含：uni-app 小程序（见 需求评估文档.md）。
2. OpenClaw 宿主（关联 21 号）
- 参照工程：21-OpenClaw初始化工程/code/openclaw — 用于文档层说明工作区布局、配置与网关概念；本阶段不修改 21 代码。
- 集成方式（规划）：
3. EvoMap / Evolver / SkillHub（概念对齐）
| 来源 | URL | 在本项目中的用法 |
|---|---|---|
| EvoMap | https://evomap.ai/zh | 资产可审计、可分发 的产品叙事；Hub/Worker 可作为二期联邦分发，非 MVP 依赖。 |
| Evolver | README.zh-CN | 进化助手：仅生成受约束的提示词/配置草稿；不承担自动改代码；与本平台「定制交付工单」可弱关联。 |
| SkillHub | capability-evolver | 中国区 Skills 展示与分类 的体验对标；API 集成二期评估。 |
4. MCP 与 Skills（产品约束）
- MCP 遵循 Model Context Protocol 通用描述；平台存储 server 元数据、manifest 快照、版本与签名。
- 安全：平台进程不默认拉起用户 MCP Server；执行环境在客户 OpenClaw/本地。
5. 待官方核实（第三方摘要）
以下来自公开文章/社区，用于内部产品与培训表述，报价与容量不得绑定未经核实的数字：
- OpenClaw 与 MCP、Skills 市场、团队共享技能配置等描述（参见各类「OpenClaw + MCP」导读站点）。
- 实际能力以用户部署的 OpenClaw 版本与官方文档为准。
6. 成本与第三方服务（占位）
| 服务 | 用途 | 估算 |
|---|---|---|
| 对象存储 | 能力包、大体积 SKILL 归档 | 待评 |
| 向量 API | embedding / query | 待评 |
| 支付 | 微信/支付宝 | 按通道费率 |
7. 可观测性与告警闭环
- 日志：结构化 JSON（requestId / traceId 占位：贯穿网关 → 应用 → 下游）；错误日志带
error_signature（稳定哈希或规则 ID），便于与interaction_map观测检索对齐。 - 指标：API QPS、P95/P99、搜索耗时、向量调用失败率、Bundle 下载成功率、Redis/MySQL 连接池饱和度。
- 追踪：可选接入 OpenTelemetry；MVP 至少保证 traceId 在响应头返回（如
X-Trace-Id），与api-contract.json中errors说明一致。 - 告警：错误率、延迟、磁盘/备份失败联动值班；与
阶段2-3高负载与稳定性填写模板中 RTO 演练挂钩。
flowchart LR
REQ[请求] --> GW[网关]
GW --> APP[Midway]
APP --> LOG[日志/指标]
APP --> TRACE[traceId]
LOG --> DASH[看板]
DASH --> ALT[告警]
8. 物理视图、部署分档与数据库安全
- L0–L3 分档：与《需求评估文档》§1.4.1 一致；L2 起搜索/向量独立部署，前置负载均衡。
- 拓扑（L2 示意）：
flowchart TB
LB[负载均衡]
LB --> N1[Node 应用 1]
LB --> N2[Node 应用 2]
N1 --> RDS[(MySQL RDS)]
N2 --> RDS
N1 --> REDIS[(Redis)]
N2 --> REDIS
N1 --> ES[(搜索可选)]
N2 --> VEC[(向量服务)]
- 数据库安全分级：备份频率、加密、脱敏、审计留存与 RPO/RTO 目标按
阶段2-3数据库安全分级模板.template.md填写；生产库账号最小权限，迁移与运维双人复核（见高可用治理矩阵模板）。
9. 开源与公开规范对标（表述边界）
| 类型 | 引用 | 说明 |
|---|---|---|
| 官方规范 | Model Context Protocol | MCP manifest 与工具描述字段对齐；不暗示平台托管用户 Server 进程。 |
| 官方/上游（示例） | github.com/openclaw（若仓库路径随版本变更以实际为准） | 文档层对齐工作区与网关概念；本仓 21 号工程为内部参照副本。 |
| 第三方产品 | EvoMap、Evolver、SkillHub | 叙事与体验对标；API/联邦集成非 MVP，报价不绑定其 SLA。 |
| 社区 Skills | 各仓库 SKILL.md / Agent Skills 约定 | 资产导入时做许可证与来源字段校验；不自动执行未评审包。 |
| 第三方目录（参考） | 网络上可见的 Skills / ClawHub 类介绍站点 | 仅作「发现—安装—审计」产品叙事对照；不得将外部文章中的数量、安全结论写进合同 SLA。 |
对外口径：官方指 MCP 规范与 OpenClaw 上游文档；第三方指 EvoMap/SkillHub 等商业或社区站点，功能以合同与验收为准。
10. Agent API 与贡献结算（实现索引）
- Agent：
POST /open/v1/agent/skill/publish、POST /open/v1/agent/skill/subscribe（见api-contract.json模块agent_exchange）；鉴权为 Agent Credential，与人类 JWT 分域。 - 上传：
POST /open/v1/upload/init预签名，避免大文件经应用服务器。 - 交付下载：
GET /open/v1/delivery/bundles、POST /open/v1/delivery/sign（门户下载中心；见api-contract.json模块delivery）。 - 结算：
POST /admin/occapSettlement/ledger/page、POST /admin/occapSettlement/batchClose；账本表只追加，批次带 MerkleRoot 便于导出对账（非区块链存证，除非另行接入）。