核心功能与定位
consensus-interact 是基于 @consensus-tools/consensus-tools 引擎的共识决策工具技能,专为需要高可信度决策的代理系统(agentic systems)设计。它实现了本地优先(local-first)的架构理念,同时可选接入 hosted 网络层,支持在多LLM环境中运行基于策略的决策工作流。
核心用法
该技能提供完整的 CLI 工具链与 Agent 工具集成:
工作流五步闭环:
1. 发布任务(jobs post)— 支持 SUBMISSION(提交模式)或 VOTING(投票模式)
2. 代理提交(submissions create)— 附带置信度自评与结构化产物
3. 投票表决(votes cast)— YES(+1)/NO(-1) 二元投票机制
4. 任务结算(resolve)— 按策略自动或人工裁定胜出者
5. 获取结果(result get)— 可信输出供下游使用
三种核心策略:
FIRST_SUBMISSION_WINS:速度优先,最早提交获胜HIGHEST_CONFIDENCE_SINGLE:置信度最高者胜(依赖自报告)APPROVAL_VOTE(推荐):民主投票制,支持法定人数(quorum)、最低分差(minMargin)、平局打破(tieBreak)等精细控制;结算可选immediate(全自动)、staked(质押奖惩)或oracle(可信仲裁人)
双模架构:
- 本地模式:JSON/SQLite 存储,完全离线,适合开发与单机部署
- 全局模式:对接 consensus.tools 托管服务,需配置 accessToken 与显式启用
safety.allowNetworkSideEffects
显著优点
| 维度 | 优势 |
|------|------|
| **架构理念** | 本地优先设计,数据主权归用户,托管层仅为可选网络插件 |
| **决策可信度** | 多LLM交叉验证 + 可审计投票链,降低单一模型幻觉风险 |
| **策略弹性** | 从极速模式到质押治理,覆盖从实验到生产的全场景 |
| **安全默认** | `allowNetworkSideEffects: false`、`requireOptionalToolsOptIn: true`,突变工具默认关闭 |
| **生态兼容** | OpenClaw 插件原生支持,也可独立 npm CLI 使用 |
潜在局限与风险
1. 本地模式并发限制:JSON 后端仅适单机,SQLite 虽改善并发但仍非分布式方案
2. 策略配置复杂度:APPROVAL_VOTE 的参数调优(quorum、margin、settlement)需领域知识,误配可能导致决议僵局或操纵漏洞
3. 质押机制数学风险:staked 结算模式的"错误投票"罚没逻辑若设计不当,可能引发选民冷漠或女巫攻击
4. 全局模式依赖:hosted 服务的可用性与 token 安全成为外部依赖点
5. 工具调用边界:mutating tools 虽可禁用,但平台级工具调用开关若配置失误仍有自主行为风险
适合人群
- 构建多代理协作系统的开发者,需仲裁多个LLM输出的冲突
- 追求可审计、可复现决策的 AI 安全研究者
- 需要渐进式去信任化的团队:从本地人工仲裁(oracle)逐步过渡到自动质押共识
- OpenClaw 生态用户,寻求结构化扩展代理能力的插件
安全建议
- 生产部署前保持 local + oracle 组合,人工审核决议逻辑
- 启用全局模式时,accessToken 应通过密钥管理服务注入,避免硬编码
- 定期审查
ai-self-improvement.md文档,理解共识机制在自我优化循环中的放大效应