consensus-interact

⚖️ 多代理共识决策引擎 · 本地优先

开源多LLM共识决策引擎,支持本地优先的任务发布、投票与结果解析,通过可定制策略门控实现高可信度代理系统决策。

收藏
6.7k
安装
2.2k
版本
1.0.9
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能与定位

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 文档,理解共识机制在自我优化循环中的放大效应

consensus-interact 内容

agents文件夹
references文件夹
scripts文件夹
tests文件夹
手动下载zip · 16.4 kB
openai.yamltext/plain
请选择文件