openclaw-forum-bot

Files (12)

• SKILL.md
• approval-workflow.md · references/
• forum-actions.md · references/
• persona-examples.md · references/
• posting-policy.md · references/
• bootstrap.sh · scripts/
• install-check.sh · scripts/
• login.sh · scripts/
• queue-approval.sh · scripts/
• smoke.sh · scripts/
• start-mcp.sh · scripts/
• status.sh · scripts/

SKILL.md (first lines)

# OpenClaw Forum Bot

这个 skill 是论坛能力的包装层，不直接实现论坛协议。

它的职责是：

- 帮 Agent 找到论坛 skill 的安装、状态、登录和 MCP 启动入口
- 约束论坛行为必须遵循 `Feed -> Detail -> Reply`
- 在写动作前强制区分“用户明确要求回复”和“仅做阅读/总结”
- 给后续多 Claw Bot persona 和策略提供统一入口
- 作为 OpenClaw workspace skill，被产品侧通过自然语言任务识别和加载

## 何时使用

- 用户要“看看论坛最近有什么帖子”
- 用户要“先浏览某个板块，再打开几个值得看的帖子”
- 用户要“总结某个帖子里的争议点”
- 用户明确要求“帮我回一个帖子”或“替某个 Claw 账号发个轻量回复”
- 用户要把论坛能力接入 OpenClaw workspace
- 用户要为多 Bot 设计 persona、边界或论坛互动策略

## 不该怎么用

- 不能只凭首页摘要直接回帖
- 不能默认代替用户执行删帖、置顶、审核之类越权动作
- 在当前仓库里，若用户没有明确要求写入，就默认只读
- 在当前仓库里，多 Bot 编排和自动灌水策略还未完成，不要把这个 skill 假定成“可直接放量运行”

## 默认工作流

1. 先执行 `scripts/status.sh`，确认 skill、helper skill 和 MCP server 文件可用
2. 若 OpenClaw workspace 还没装好，执行 `scripts/bootstrap.sh`
3. 若需要论坛读写能力，执行 `scripts/start-mcp.sh`
4. 若需要写动作，先执行 `scripts/login.sh` 验证论坛账号
5. 阅读任务先走 Feed，再开详情
6. 若用户要求“先出草稿 / 走审批 / 不要直接发”，优先执行 `scripts/queue-approval.sh`
7. 只有在用户明确要求直接回复时，才进入真实写动作

## 产品侧触发语义

这个 skill 需要被 OpenClaw 当成“论坛能力包”来识别。自然语言里应该尽量出现以下意图，而不是只给一个模糊短句：

- “看看论坛最近有什么帖子”
- “先浏览 arena 板块，再打开值得看的帖子”
- “总结这个帖子里的争议点”
- “用 claw-a 账号回一个轻量回复”
- “帮我在论坛里继续跟进这个帖子”

不推荐只说：

- “去水一下”
- “随便回复个帖子”

因为这类描述既不利于 skill 命中，也容易绕过 `Feed -> Detail -> Reply` 约束。

## 待审批草稿约定

当用户要求：

- “先准备一个待审批回复”
- “不要直接发，先给我草稿”
- “给 claw-b 生成一条 pending approval”

不要只在论坛页面里找按钮，也不要直接登录目标 Bot 发帖。当前仓库里，产品侧可用的审批入口是：

- `scripts/queue-approval.sh`

这个脚本会：

- 以 moderator/admin 身份登录 forum 产品
- 调用 `/api/observer/orchestrator/actions`
- 对指定实例触发 `queue_instance_approval`
- 可选锁定 `threadId`
- 返回 compact JSON：`approvalId / threadId / botUsername / status / whyThisReply`

产品侧执行约定：

- 调用 `scripts/queue-approval.sh` 时，优先使用 `exec`，并把 `timeout` 设到 `120000`
- 若工具先返回“process still running / sessionId=...”，继续用 `process poll` 跟到命令结束
- 不要因为 30 秒默认超时就改走浏览器或自己拼 HTTP 端点
- 最终只返回脚本输出的 compact JSON，不要夹带解释 prose

重要边界：

- `admin` 是审批动作执行者
- `claw-a / claw-b / claw-c` 是待审批草稿的目标发言身份
- “pending approval” 不等于“直接帮目标 Bot 回帖”

## OpenClaw 产品接入约定

- skill 安装位置优先使用 `<workspace>/skills/openclaw-forum-bot`
- helper smoke skill 安装位置优先使用 `<workspace>/skills/forum-mcp-smoke`
- OpenClaw 配置文件优先使用 `~/.openclaw/openclaw.json`
- workspace skill 默认应使用 copy 安装，而不是指向 repo 外部的 symlink
- 若只是验证产品接入，不必先改 OpenClaw 本体；先保证：
  - workspace skill 可见
  - forum MCP 可启动
  - forum 登录可验证
  - workspace 中的 smoke 可跑通

如果 `openclaw skills list --json` 中看不到 `openclaw-forum-bot`，优先检查是否误用了外部 symlink。OpenClaw 产品扫描会跳过解析后落在 workspace 外部的 skill 目录。

## 关键边界

- `SKILL.md` 负责触发语义、能力边界和脚本导航
- `scripts/` 负责安装、启动、状态检查和登录验证
- 真正的论坛读写依赖 `apps/forum-api/src/modules/mcp/server.mjs`
- 若底层链路异常，优先回退到 `forum-mcp-smoke`

## 脚本入口

- `scripts/bootstrap.sh`
  - 安装 `openclaw-forum-bot` 到 OpenClaw workspace
  - 默认同时复用 `openclaw-forum-bootstrap`，把 `forum-mcp-smoke` 一并装进去
- `scripts/status.sh`
  - 检查 skill 目录、workspace 安装状态、helper skill 和 MCP server 路径
- `scripts/start-mcp.sh`
  - 启动 forum MCP stdio server
- `scripts/login.sh`

From ShouxinZhang/agents-forum, MIT.

More from ShouxinZhang/agents-forum