OpenClaw Consensus

OpenClaw Consensus MCP

在 MCP 客户端中实现多模型共识：比较答案、发现分歧，并仅在必要时升级处理。

OpenClaw Consensus MCP 将 OpenClaw Consensus API 封装为三个 Model Context Protocol 工具。它适用于维护者希望在接受有风险的答案、审查摘要或路由决策之前获得第二意见的工作流。

功能

OpenClaw 会将相同的提示词提交给多个模型，然后返回：

• 带有置信度和模型响应元数据的共识答案，
• 根据深度共识响应得出的分歧启发式指标，以及
• 成本最低的路由建议，尝试使用规模较小的模型集，必要时再升级。

此 MCP 服务将这三项功能作为工具提供，让 Claude Desktop / Claude Code 可以在对话过程中调用。

为什么需要共识？

单个模型可能会给出自信却错误的答案。比较多个响应并不能证明答案正确，但意见分歧是一个有用的信号，提醒维护者更仔细地审查输出。

安装

pip install openclaw-consensus-mcp
# or
uv pip install openclaw-consensus-mcp

你还需要 OpenClaw Consensus API 的 RapidAPI 密钥： https://rapidapi.com/yanmiayn/api/openclaw-consensus

在环境中设置该密钥：

export RAPIDAPI_KEY="your-rapidapi-key"

Claude Desktop 配置

添加到 ~/.claude/claude_desktop_config.json（macOS/Linux）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "openclaw-consensus": {
      "command": "openclaw-consensus",
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key"
      }
    }
  }
}

对于 Claude Code：

claude mcp add openclaw-consensus -- openclaw-consensus

工具

consensus(prompt, mode="balanced")

获取 9 个大模型的共识答案。

• prompt (string) — 问题。
• mode (string, default balanced) — deep（9 个模型）、balanced（5 个）或 fast（3 个）。

返回

{
  "consensus": "string",
  "confidence": 0.0,
  "models_responded": 5,
  "votes": []
}

consensus 工具会原样返回上游 API 响应。随着端点演进，字段可能会增加。

disagreement_score(prompt)

衡量深度共识响应对某个提示词的分歧程度。

返回

{
  "disagreement": 0.0,
  "confidence": 1.0,
  "models_responded": 9,
  "votes": []
}

cheapest_route(prompt, target_quality=0.85)

依次尝试 fast、balanced 和 deep 模式，直到达到置信度阈值。

返回

{
  "selected_mode": "balanced",
  "models_used": 5,
  "confidence": 0.9,
  "answer": "string"
}

本地开发

git clone https://github.com/MICONNM/openclaw-consensus-mcp
cd openclaw-consensus-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

使用官方 MCP Inspector 对服务进行冒烟测试：

npx @modelcontextprotocol/inspector openclaw-consensus

发布

uv build
uv publish      # to PyPI
mcp-publisher publish   # to the official MCP Registry

开发工作流请参阅 CONTRIBUTING.md；分流、审查、安全和发布职责请参阅 docs/maintainer-workflow.md。

限制

• 共识仅用于辅助审查，不能保证正确性。
• 依赖网络的工具需要配置 OpenClaw 端点，且可能产生服务提供商费用。
• 除非你的端点策略明确允许，否则不要发送密钥、私有源代码或个人数据。

安全

请按照 SECURITY.md 中的流程私下报告漏洞。

许可证

MIT — 详见 LICENSE。