竞技场 — AI 辩论主持人

将任意 Discord 服务器转变为结构化辩论竞技场，配备 AI 主持、公平裁决与持久化记分板。

前提条件

本技能需满足以下要求。所有配置均不会自动完成——所有特权操作均需您手动审核并批准。

安全说明

• 本技能建议以独立、隔离的 OpenClaw agent身份运行，并限制工具访问权限（fs.workspaceOnly: true，exec.security: "deny"）。
• 所有配置变更均以供您审核的模板形式生成，绝不会自动应用。您必须手动审核并应用全部 gateway 配置补丁。
• 所附脚本（scripts/setup.sh、scripts/scoreboard.sh）仅在技能 workspace 内创建文件，不发起任何网络请求，也不在技能目录外写入任何文件。运行前请务必检查脚本内容——二者均为纯 Bash 脚本，无混淆代码，每份均不超过 400 行。
• 记分板 SQLite 数据库创建于技能目录下的 ./data/scoreboard.db（若设置了 $DEBATE_SCOREBOARD_DB，则使用其指定路径），且绝不向 skill workspace 外写入数据。
• 在竞技场频道中设置 requireMention: false 意味着机器人将处理该频道中的每一条消息。这会增加 token 消耗与数据暴露面。如需降低成本并减少可见性，请使用 requireMention: true。

快速上手

输入 “搭建一个辩论服务器”，agent 将引导您完成各项配置选项，并为您生成待审核的配置模板。

接入流程

步骤 1 — 选择服务器

新建一个 Discord 服务器，或选择一个已有服务器。您需要获取该服务器的 guild ID（启用开发者模式后，右键点击服务器图标 → 复制服务器 ID）。

步骤 2 — 选择主持人角色

选择主持人在辩论中使用的语气风格。默认为：Scholar。

详见 references/personas.md。

步骤 3 — 选择默认辩论格式

当用户未显式指定格式而发起辩论时所采用的默认格式。默认为：Campfire。

详见 references/formats.md。

步骤 4 — 裁决标准权重

自定义主持人对论点的评分维度权重。默认值如下：

各权重之和必须为 100%。详见 references/judging.md。

步骤 5 — 配置频道

默认频道名称（全部可自定义）：

步骤 6 — 生成配置（供您审核）

agent 将根据您的选择生成配置片段及一份定制化的 AGENTS.md。您必须审核并手动应用全部 gateway 配置变更。agent 不会自动应用 config patch。完整配置模板与分步操作指南请参见 references/setup-guide.md。

重要提示： agents.list 和 bindings 均为数组类型，config.patch 将完全替换其原有内容。请始终审阅完整补丁，确保您现有的 agents 和 bindings 得以保留。

步骤 7 — 创建频道并发布欢迎消息

您在 Discord 中完成频道创建后，agent 可从 assets/welcome-messages.md 自动发布欢迎消息；您亦可自行复制粘贴。

步骤 8 — 发布规则

agent 将在 #rules 频道中发布完整的规则文档。

配置参考

主持人角色

控制主持人的语言风格与点评方式。

• Scholar（默认）—— 深思熟虑、语调平和
• Sports Commentator —— 充满激情、实时解说感强
• Philosopher —— 苏格拉底式追问、层层深入
• Comedian —— 机智幽默、略带戏谑（但仍保持公正）
• Drill Sergeant —— 严厉直接、强调实证
• Custom —— 您可提供自定义的角色描述

默认辩论格式

当辩论未明确指定格式时所采用的格式。

• Campfire（默认）、Oxford、Lincoln-Douglas、Hot Takes、Devil's Advocate、Roundtable

裁决权重

可自定义四项评分标准的权重，总和必须为 100%。

• Evidence & Reasoning —— 信息来源质量、逻辑结构严谨性（默认 35%）
• Engagement —— 回应对手观点、紧扣议题（默认 25%）
• Intellectual Honesty —— 承认对方合理观点、避免稻草人谬误（默认 20%）
• Persuasiveness —— 修辞效果、表达清晰度（默认 20%）

频道名称

全部五个频道均可重命名。您可在配置过程中提供映射关系。

requireMention

• true（默认，推荐）—— 主持人仅在被 @ 提及后响应。开销更低、数据暴露更少。参与者通过提及主持人来控制辩论节奏。
• false —— 主持人监听频道内全部消息，可能主动介入。token 消耗更高、数据暴露更大。仅推荐用于成员互信、消息量极低的小型服务器。

裁决风格

主持人宣布最终裁决的方式。

• Detailed —— 完整记分卡，含各维度得分与详细评述
• Brief —— 公布获胜方，并附一段简要总结
• Dramatic —— 戏剧化裁决，包含铺垫与渲染

记分板

• on（默认）—— 基于 SQLite。记录胜/负场次、辩题、格式等信息。
• off —— 不进行持久化追踪。

CLI 工具：scripts/scoreboard.sh。数据库位置：$DEBATE_SCOREBOARD_DB 或 ./data/scoreboard.db。

辩论超时时间

主持人标记辩论陷入停滞前的小时数。默认值：48。

最大并发辩论数

竞技场中允许同时进行的辩论数量上限。默认值：3。

话题限制

• unrestricted（默认）—— 无话题禁区。主持人仅依据论证质量进行裁决，不预设主题限制。
• restricted —— 请提供禁止讨论的话题或类别列表。

工作原理

提出辩题

在 #propose-a-topic 频道中发布：

Topic: [您的辩题]
Format: [可选 — 默认采用服务器全局设定]

其他成员可通过 👍 表情表达兴趣。当至少两人准备就绪时，任一成员均可说 “我们来辩论吧”，将话题转入竞技场。

启动辩论

在 #the-arena 频道中，主持人将：

1. 宣布辩题与所用格式
2. 分配或确认正反方立场（Roundtable / Hot Takes 格式除外）
3. 发布该格式对应的具体规则
4. 发起开场陈词环节

参与者也可直接在竞技场中启动辩论：

@Moderator start debate: "菠萝应该放在披萨上" [format: hot-takes]

辩论进行中

主持人的行为依所选格式而异：

• Campfire —— 实时插话以梳理逻辑脉络、指出谬误、推动回应
• Oxford —— 严格把控轮次、计时与发言顺序
• Lincoln-Douglas —— 严格执行正反方交替发言机制
• Hot Takes —— 收集每位参与者的一条发言，随后统一裁决
• Devil's Advocate —— 监督参与者是否确实在反驳自身明确认同的观点
• Roundtable —— 提出启发性问题，归纳整合各方观点

主持人持续识别逻辑谬误、监测参与均衡性，并推动辩论进程。在仅限 @ 提及模式下，参与者需主动 @ 主持人以请求介入。

发起裁决请求

• 任一辩手声明 “我陈述完毕”
• 主持人可在长时间无人发言后主动发起裁决
• 主持人执行 就绪确认（ready check）：双方均需明确确认方可裁决

裁决结果

主持人依据已配置的裁决权重进行评估，并按所选风格发布裁决结果。结果将同步发布至 #the-arena 与 #hall-of-records 频道。

记分板

当记分板功能启用后，结果将被自动记录。

支持的命令（通过 scripts/scoreboard.sh）：

scoreboard.sh init                              # 创建数据库
scoreboard.sh record      # 记录单场结果
scoreboard.sh leaderboard                       # 展示排行榜
scoreboard.sh history [--limit N]               # 查看近期辩论（可选限制条数）
scoreboard.sh stats                # 查询某位参与者的个人统计
scoreboard.sh reset                             # 清空全部数据

主持人应在每次发布裁决结果、以及用户查询排名时，自动执行相应命令。

频道行为对照表

安全模型

辩论主持人必须作为独立的 OpenClaw agent运行，并严格限制权限。这是关键要求，因为辩论服务器具有半公开属性——其他用户会与机器人交互，而提示注入（prompt injection）风险真实存在。

推荐的 agent 权限限制：

• tools.fs.workspaceOnly: true —— 仅允许读写技能 workspace 内文件
• tools.exec.security: "deny" —— 禁止执行 shell 命令
• tools.deny 列表禁用：exec、process、nodes、cron、gateway、browser、canvas、sessions_*、subagents、memory_search、memory_get、tts、image
• tools.profile: "messaging" —— 仅开放 Discord 消息收发 + 网络搜索（用于事实核查）

上述限制确保：

• 无法访问所有者个人文件、私聊消息或其他 agent
• 无法发送邮件、读取日历，或接入其他外部服务
• 即使参与者尝试实施提示注入攻击，也无可窃取的敏感信息

所有配置变更均由您全权负责。 agent 仅生成模板；您负责审核与应用。完整安全配置与经验证的工具禁用列表详见 references/setup-guide.md。

文件参考