Skip to content

docs(openspec): OpenClaw SDK 集成规范与实施路线 - #2

Draft
loong10k wants to merge 2 commits into
mainfrom
docs/openclaw-openspec-integration-20260920
Draft

loong10k wants to merge 2 commits into
mainfrom
docs/openclaw-openspec-integration-20260920

Conversation

@loong10k

Copy link
Copy Markdown
Collaborator

概要

将已生成的 OpenSpec 草案作为独立文档提交发布到仓库,供评审;本 PR 不包含 SDK 实现,也不代表实现范围已获批准。

共新增 62 个文档及辅助文件,仅涉及 openspec/docs/openclaw-integration/。保留现有 Java 源码、测试、pom、构建配置及根 README;三条 SDK 发行分支不做修改。

规范范围

  • G0 establish-sdk-compatibility-governance:版本与三分支兼容治理。
  • G1 fix-openclaw-protocol-contracts:Responses SSE、聊天替换/运行关联、设备认证、历史与 Tools Invoke。
  • G2 add-managed-gateway-client:公共 RPC、连接恢复、订阅对账及类型化事件。
  • G3 add-agent-session-approval-control:Agent、Session 与审批执行闭环。
  • G4 add-gateway-operations:配置、Cron、目录、扩展、渠道/Node、审计与产物。
  • G5 add-optional-runtime-adapters:终端、语音、MCP/ACP 和 CLI 适配。

共 21 个能力规范、64 条 Requirement、128 个 Scenario、97 项未勾选实施任务;包含来源登记、覆盖基线、依赖路线、验收计划和逐场景追踪表。状态保持 DRAFT / REVIEW_REQUIRED,没有归档为生效规范。

入口与打包

docs/openclaw-integration/README.md 开始阅读。为保护原项目说明,文档包根索引迁入上述目录。

较大 JSON 附件无损打包:追踪 JSON 使用 gzip,完整结构检查报告使用 gzip + Base64 分段;恢复方式与原始校验值记录在 validation-report/README.mdpackage-manifest.json。可直接阅读 Markdown 追踪表与摘要。

验证

已完成文档格式/引用/任务数量检查、原包完整性核验,以及准备发布文件与 GitHub 完整目录树哈希比对。最终 tree:7c502bd8da065df86a16de1976b362fcb0b4c2f9;既有项目文件未改变。

以下均为 NOT_RUN,不得将文档检查冒充这些验证:官方 OpenSpec CLI strict 校验、SDK 构建和测试、codegraph、真实 Gateway 集成及安全/资源分析。

评审重点

先评审 G0 与 G1,锁定目标 OpenClaw 精确版本/提交,再批准后续实现。提交与推送不自动批准代码实施、管理写操作或规范归档。本 PR 保持 Draft,未请求自动合并。

loong10k and others added 2 commits September 20, 2026 22:22
Add six draft changes, 21 capability specifications, 64 requirements,
128 scenarios, and 97 unchecked implementation tasks.

Include source baselines, roadmap, acceptance plan, traceability and
losslessly packaged document-validation evidence. Preserve existing
SDK sources, tests, build files, and root READMEs.

Documentation only: no implementation approval, official OpenSpec CLI
validation, SDK builds, or live Gateway tests are claimed.
…校验 6/6

- 任务 1.2/1.3/2.1/3.3/3.4 完成并附证据工件(evidence/)
- 1.1/2.2/2.3/2.4/3.1/3.2/3.5 标注人审或环境阻塞原因,G1 编码保持阻断
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant