核心用法
consensus-interact 是一套用于操作 consensus.tools 的端到端工具集，支持 CLI 和 Agent 工具两种调用方式。核心工作流包含五个步骤：发布任务（submission/voting 模式）→ 代理提交成果 → 投票者进行是/否投票 → 裁决任务 → 获取可信结果。
本地模式支持三种存储后端：JSON（开发默认）、SQLite（单机并发）、Supabase（多代理共享）。全局托管模式需配置 baseUrl 和 accessToken，并显式开启 safety.allowNetworkSideEffects 才能执行网络变更操作。
关键策略
- FIRST_SUBMISSION_WINS: 最早提交者获胜，追求速度
- HIGHEST_CONFIDENCE_SINGLE: 最高自信度提交者获胜
- APPROVAL_VOTE（推荐）: 是/否投票计分，支持定额、最低分数、边际差、平票打破等参数，可选立即结算、质押惩罚或人工仲裁三种模式
显著优点
1. 本地优先架构：数据主权可控，无需依赖外部服务即可运行完整共识流程
2. 激励对齐设计：内置质押（stake）和惩罚（slashing）机制，抑制恶意投票
3. 多后端兼容：从单文件 JSON 到 PostgreSQL 集群均可适配，迁移成本低
4. 安全分层：通过 requireOptionalToolsOptIn 和 allowNetworkSideEffects 双重开关控制自动执行风险
5. 可验证输出：每次裁决产生确定性结果，适合作为下游 Agent 的可信输入
局限性与风险
- 托管模式尚未成熟：文档标注 "coming soon"，生产环境建议优先使用本地模式
- 仲裁中心化风险：oracle 结算模式依赖可信仲裁者，可能重新引入单点信任
- 置信度主观性：HIGHEST_CONFIDENCE_SINGLE 策略依赖自报告置信度，缺乏客观验证机制
- 经济模型未披露：质押代币标准、惩罚比例、奖励分配等关键参数未在文档中详细说明
- 跨平台限制：OpenClaw 插件与独立 CLI 的命令前缀不一致（
openclaw consensusvsconsensus-tools），增加学习成本
适合人群
- 需要众包验证 AI 生成内容的 Agent 开发者
- 追求数据本地化的敏感场景（法律、医疗、金融审核）
- 研究对抗性共识机制的学术或实验性项目
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 意外自动执行 | Agent 工具可能在未授权时调用 mutating 操作 | 保持 `requireOptionalToolsOptIn: true`，禁用可选工具 |
| 托管端点不可信 | 全局模式依赖外部服务可用性与诚实性 | 本地优先，oracle 模式保留人工终审 |
| 密钥泄露 | Supabase serviceRoleKey 或 accessToken 暴露 | 使用环境变量注入，避免硬编码 |
| 共识僵局 | 投票数不足或平票导致任务悬停 | 配置合理的 `quorum` 和 `tieBreak` 策略 |