Settlement Witness

核心功能

SettlementWitness 是 OpenClaw 生态中的结算见证技能，用于为 AI 任务执行结果生成可重放、签名化的数字收据（Signed Attestation Receipt v0.1）。通过对比任务规范（spec）与实际输出（output），返回 PASS/FAIL/INDETERMINATE 三种确定性结论，并附带唯一的 receipt_id 和 reason_code，为自动化结算提供不可抵赖的审计凭证。

显著优点

• 确定性验证：无状态设计确保相同输入始终产生相同收据，支持结果重放与第三方审计。
• 双协议支持：原生支持 MCP（Model Context Protocol）和直接 REST，便于集成到不同架构。
• 跨平台友好：提供 Linux/macOS 与 Windows PowerShell 的完整 curl 示例，规避 PowerShell 的 common pitfall（Invoke-WebRequest 别名导致的 422 错误）。
• 标准化输出：SAR v0.1 格式包含 receipt_id、reason_code 等机器可读字段，便于自动化处理。

局限性与风险

• 输入敏感限制：明确禁止在 spec/output 中传输密钥或敏感数据，否则存在泄露风险。
• 外部依赖：核心服务托管于 defaultverifier.com，可用性与安全性依赖该域名的持续运维。
• 协议版本锁定：当前仅支持 SAR v0.1，未来版本升级可能存在兼容性迁移成本。
• INDETERMINATE 状态需人工介入：该中间状态未定义自动重试策略，需调用方自行实现降级逻辑。

适合人群

• 构建 AI 代理结算系统的开发者
• 需要任务执行可审计凭证的企业合规团队
• 采用 MCP 架构的 OpenClaw/Claude 生态集成者

常规风险提示

• 网络层未提及 TLS 强制校验细节，生产环境建议额外验证证书链。
• 收据签名算法与密钥管理逻辑未在文档中披露，需查阅 SAR v0.1 完整规范评估密码学安全性。

核心用法

settlement-witness 是一个 MCP（Model Context Protocol）协议使用指南技能，本身不执行任何代码，而是提供标准化的 API 调用文档，帮助开发者为 AI 任务生成可重放、防篡改的结算收据（SAR v0.1）。用户通过调用 SettlementWitness 的 REST API 或 MCP 端点，提交任务 ID、预期规格（spec）与实际输出（output），即可获得包含 PASS/FAIL/INDETERMINATE 状态的签名收据，用于任务完成度的链式验证与自动结算。

典型调用流程

1. 任务执行前记录 task_id 与预期 spec
2. 任务完成后收集实际 output
3. POST 至 defaultverifier.com/settlement-witness 或 MCP 端点
4. 解析返回的 JSON 收据，根据 status 字段决定结算策略

显著优点

• 确定性验证：收据包含稳定标识符（receipt_id）与标准化原因码（reason_code），支持审计追踪
• 无代码依赖：纯 Markdown 文档型技能，零第三方依赖，零运行时风险
• 跨平台兼容：提供 Linux/macOS cURL 与 Windows PowerShell 完整示例，降低接入门槛
• 协议标准化：基于 SAR v0.1 签名收据规范，可与区块链、智能合约等结算系统对接
• 状态机清晰：PASS/FAIL/INDETERMINATE 三种终态覆盖全部结算场景

潜在缺点与局限性

• 外部服务依赖：所有验证逻辑托管于 defaultverifier.com，存在单点可用性风险
• 无本地回退：若外部 API 不可达，无法生成离线收据
• 收据语义有限：仅支持基于 spec/output 匹配的确定性验证，无法处理主观质量评估
• 版本锁定风险：SAR v0.1 为早期版本，未来协议升级可能导致兼容性中断
• 网络延迟敏感：实时结算场景下，API 往返延迟可能成为瓶颈

适合的目标群体

• 构建 AI Agent 结算系统的协议开发者
• 需要可审计任务日志的企业级 AI 工作流架构师
• 探索去中心化 AI 市场的区块链/DWeb3 开发者
• 追求确定性输出验证的科研自动化平台（如自动论文评审、实验复现）
• 需要将 AI 服务与智能合约自动结算对接的 DeFi 产品经理

常规使用风险

| 风险类型 | 具体表现 | 缓释建议 |

|---------|---------|---------|

| 网络可用性 | defaultverifier.com 服务中断 | 实现指数退避重试，INDETERMINATE 状态触发人工审核 |

| 数据隐私 | spec/output 内容经 TLS 传输至第三方 | 严格遵循文档安全提示，绝不在 payload 中嵌入密钥、PII 或商业机密 |

| 确定性偏差 | 浮点数、时序等导致 spec/output 匹配失败 | 预处理输出为规范格式（如 JSON 序列化后哈希），避免直接比较原始值 |

| 域名劫持 | 恶意 DNS 将请求导向伪造端点 | 固定证书指纹校验，或自建 SettlementWitness 节点 |

| API 限流 | 高频调用触发速率限制 | 实现本地收据缓存与批量提交机制 |

> 该技能本身不执行任何操作，风险主要存在于用户实际调用外部 API 的环节。建议生产环境部署前对 defaultverifier.com 进行独立的 SLA 与合规审计。