技能介绍

要解决什么问题

当你想买书、订服务或排期，对方也是 AI Agent 时，来回报价、改约束、确认条款往往要人一直盯着聊天窗口。Clinch（Agent Negotiation Protocol，ANP）把整条协商循环交给本地 clinch CLI 与守护进程处理：提案、还价、确认状态机由协议驱动，只有进入 CONFIRMED 且你明确点头之后才会调用 clinch approve 完成密码学签名。

技能如何工作

买方侧典型流程：

把用户意图整理成严格 JSON 约束（含 item、max_budget 等；纯排期可将 max_budget 设为 null），执行 clinch negotiate --direct 解析返回的 session.state（PROPOSED / COUNTERED / CONFIRMED / CANCELLED）。
卖方还价时用 counter；成交前用 status 查本地会话（无需解锁 vault）。
用户确认后执行 approve，成功时得到 status: "SIGNED" 与 artifact（含双方签名与 artifact ID）。

卖方侧包括 clinch node register（公开 HTTPS 端点）、serve 启动 HTTP 服务（可配置底价、自动批准阈值、maxTurns），以及通过 OpenClaw webhook 处理 approval_required、counter_received、session_cancelled 等事件。

每次涉及 vault 的操作前需检查二进制与 CLINCH_PASSPHRASE；禁止把原始用户消息当 intent 传入，也禁止在未获用户确认时调用 approve。

适用边界与注意点

注册表无匹配节点会出现 “No sellers found”；节点离线为 “Seller unreachable”，需换关键词、--target 或换卖家。
clinch status 与 clinch deals 只读本地状态，不需要口令；negotiate / counter / approve / cancel / serve / register 则必须有环境变量中的 CLINCH_PASSPHRASE。
Registry 401 时 CLI 会通过 PoW 重试；若 vault 未初始化，应先 clinch init 并配置口令，且不得记录或打印口令。

截图预览

使用场景

用户要采购或预订某项服务，并提到 Clinch 或与 Agent 议价时，需把意图写成 JSON 约束并调用 `negotiate --direct` 跟踪会话状态。
与对方通过 Agent 协调预约或排期、不涉及付款时，将 `max_budget` 设为 null，在 COUNTERED 时代用户决定接受、还价或取消。
卖方节点已 `serve` 且配置 OpenClaw webhook，收到 `approval_required` 或 `counter_received` 时需转述条款并仅在用户确认后调用 `approve`。
议价进行中需查看本地 `clinch status` 或已签 `clinch deals`，或在 CONFIRMED 前用 cancel 通知对方终止会话。

适合人员

在 OpenClaw 上托管助手、需要代用户与注册表卖方 Agent 完成询价、还价与成交前人工门控的集成工程师。
在公网提供 HTTPS 服务端点、要在 Clinch 网络 `node register` 并配置底价与自动批准阈值的独立服务提供方。
日常由 Agent 发起采购但必须本人核对最终价格与标的、再授权 `approve` 签名提交的负责人或采购协作者。
首次部署需 `clinch init`、维护 `CLINCH_PASSPHRASE`，并清楚区分无需 vault 的 status/deals 与需签名的 negotiate/approve 命令的运维人员。