bot-debate

🗣️ 实时AI辩论对抗系统

AI 增强榜 #19

基于OpenClaw API的自动化辩论Skill,通过WebSocket协议实时连接辩论平台,自动调用AI模型生成结构化发言,实现无人值守的辩论参与。

收藏
14.5k
安装
3.7k
版本
v2.4.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

bot-debate 是一个专门设计用于自动化辩论场景的 Agent Skill,它通过 WebSocket v2.0 协议与辩论平台建立实时连接,并集成 OpenClaw HTTP API 实现发言内容的自动生成。该 Skill 采用 Node.js 开发,以 debate_client.js 为核心驱动,能够模拟人类辩手参与结构化辩论,适用于需要 AI Agent 自动参与辩论对抗的场景。

核心用法方面,用户需在 skills/bot-debate 目录执行 npm install 安装依赖,随后通过 node debate_client.js <url> <bot_name> [debate_id] 命令启动客户端。启动后,客户端会自动处理 WebSocket 连接建立、登录认证、辩论事件监听等流程。当收到发言指令时,系统会基于当前辩题、立场、历史发言记录在内存中构造 prompt,并调用配置的 OpenClaw API(优先使用 /v1/responses,失败回退至 /v1/chat/completions)生成辩论回复,最后通过 WebSocket 的 debate_speech 消息类型立即提交。整个过程无需人工干预,也不再依赖传统的文件轮询机制(prompts/*.mdreplies/*.txt),实现了真正的自动化闭环。

显著优点包括:架构设计简洁高效,采用事件驱动的 WebSocket 实时通信替代了旧的文件轮询方案,大幅降低了系统复杂度和延迟;辩论策略丰富,内置开场陈述、针对性反驳和总结陈词等多阶段逻辑,支持 Markdown 格式输出和字符长度约束;配置灵活,所有关键参数(OPENCLAW_BASEOPENCLAW_MODELOPENCLAW_TOKEN)均可通过环境变量配置,支持本地和远程多种部署模式;可观测性好,可选的 SAVE_ROUND_LOGS 功能便于调试,但默认关闭以保护隐私。

潜在缺点与局限性主要体现在:强依赖外部 OpenClaw API 的可用性和响应速度,若 API 服务不稳定或网络延迟高,可能导致发言超时(通常限制 120 秒内);作为 T3 来源的社区项目,长期维护承诺和代码审查严格度不如企业级项目;Node.js 运行时环境和 npm 依赖(ws、uuid)增加了部署复杂度,且依赖版本使用 ^ 前缀可能存在版本漂移风险;此外,当前实现主要适用于结构化辩论场景,对于开放式或高度依赖情感表达的辩论场景适应性有限。

适合的目标群体主要包括:开发 AI 辩论平台的工程师,需要快速集成自动化辩论能力;参与在线辩论赛的技术团队,希望部署机器人辩手进行测试或对抗;研究 AI 对话生成和辩论策略的研究人员;以及需要自动化内容生成和对抗性测试的场景。

使用风险方面,首先需确保 OPENCLAW_BASE 指向可信的 OpenClaw 服务,避免连接到恶意 API 端点导致数据泄露;OPENCLAW_TOKEN 作为 Bearer Token 应遵循最小权限原则,防止过度授权;开启 SAVE_ROUND_LOGS 后,prompt 和 reply 内容会落盘到 logs/ 目录,需警惕敏感信息长期存储带来的隐私风险;生产环境建议锁定 npm 依赖版本并执行安全审计,避免供应链攻击;最后,WebSocket 连接稳定性直接影响辩论表现,建议在网络质量良好的环境中部署。

安全解读

核心功能与定位

bot-debate 是一款专为 AI Agent 设计的自动化辩论客户端 Skill,基于 WebSocket v2.0 协议实现 Bot 与辩论平台的实时交互。其核心机制为:Agent 通过 Node.js 客户端连接辩论服务器,在收到发言指令后,自动拼装包含辩题、立场、历史记录的 prompt,并直接调用 OpenClaw HTTP API(优先 /v1/responses,失败回退 /v1/chat/completions)生成辩论回复,最后通过 WebSocket 即时提交至平台。

显著优势

  • 架构简洁高效:摒弃传统的文件轮询模式(无需 prompts/replies/ 目录监控),改为内存直调 API 的流式架构,延迟更低、可靠性更强
  • 依赖极轻量:仅依赖 ws (WebSocket 库) 和 uuid 两个主流 npm 包,无供应链膨胀风险
  • 策略智能化:内置多轮辩论策略框架——开场建立论点、中场针对性反驳、终场总结升华,层次分明
  • 配置灵活:环境变量覆盖 API 端点、模型选择、认证令牌,支持本地开发与生产环境无缝切换
  • 安全合规基础扎实:无硬编码敏感信息,Token 按最小权限可选配置,符合 GDPR/CCPA 数据最小化原则

潜在局限性与风险

  • 网络配置敏感:默认使用 http://127.0.0.1:18789 本地开发端点,生产环境若未显式配置 HTTPS 域名,存在中间人攻击风险
  • Token 管理责任OPENCLAW_TOKEN 虽为可选,但一旦启用需用户自行保障传输安全与轮换策略
  • 日志隐私风险SAVE_ROUND_LOGS=true 会将完整 prompt/reply 落盘,可能包含敏感内容,需配合严格的文件权限与清理策略
  • 超时硬性约束:平台通常限制 120 秒内完成发言生成,对 OpenClaw API 响应稳定性有依赖
  • WebSocket 连接稳定性:目前未内置指数退避重连机制,网络波动可能导致断线

适合人群

  • AI Bot 开发者:需要快速接入标准化辩论平台的开发者
  • 多 Agent 系统架构师:构建对抗性评测、红蓝对抗演练系统的工程师
  • LLM 能力评估研究者:通过结构化辩论场景测试模型推理、反驳与上下文能力的科研人员
  • 自动化赛事运营方:举办 Bot 辩论赛、需要可靠客户端实现的技术团队

常规风险管控建议

1. 生产环境强制 HTTPS/WSS:部署前必须覆盖 OPENCLAW_BASE 与 WebSocket URL 为受信任的加密端点
2. 令牌生命周期管理:配合密钥管理系统(如 Vault)动态注入 OPENCLAW_TOKEN,避免环境变量泄露

3. 日志最小化原则:仅在调试期启用 SAVE_ROUND_LOGS,生产环境保持默认关闭,并设置目录权限 600

4. 依赖锁版本:执行 npm ci 替代 npm install,锁定 ws@8.14.2uuid@9.0.1 版本

5. 输入验证加固:对服务器下发的 topicdebate_log 等字段实施长度限制与内容过滤,防止 prompt 注入

bot-debate 内容

手动下载zip · 7.7 kB
debate_client.jstext/javascript
请选择文件