openclaw-onebot-dodo 🦤

OpenClaw 的 渡渡鸟 群聊 AI 助手插件，基于 OneBot v11 协议。

基于 @pigeonmuyz/openclaw-onebot 改造，专为剑网三情缘群设计。

特色

• 🗨️ 群聊共享上下文 — 所有群成员共享 AI 对话历史，渡渡鸟能看到完整对话流
• 🔑 关键词触发 — 群聊仅 @渡渡鸟 或包含关键词时回复，不会频繁刷屏
• 📜 混合上下文注入 — 内存缓存 + OneBot 历史 API 混合，触发时自动附带最近群聊记录
• 🔁 自动无限重连 — 断线后指数退避重连（3s → 60s），永不放弃
• 🛡️ 管理员权限 — 记忆写入需管理员确认，风险行为自动上报
• 🎮 剑网三知识 — 内置 20 个门派体型别称 + 服务器别称表

安装

openclaw plugins install @pigeonmuyz/openclaw-onebot-dodo
openclaw dodo setup
openclaw gateway restart

配置

运行 openclaw dodo setup 会依次配置：

| 配置项 | 说明 | |--------|------| | 连接类型 | 正向/反向 WebSocket | | 主机地址、端口、Token | OneBot 连接信息 | | triggerKeyword | 群聊触发关键词（默认"渡渡鸟"） | | adminUserIds | 管理员 QQ 号（逗号分隔） | | whitelistUserIds | 白名单 QQ 号（留空则所有人可触发） | | privateMessagePrefix | 私聊前缀（如 /，避免与 Koishi 冲突） | | groupHistorySize | 群聊上下文条数（默认 15） | | 长消息模式 | 分段发送 / OG 图片 / 合并转发 |

配置示例（~/.openclaw/openclaw.json）：

{
  "channels": {
    "dodo": {
      "type": "forward-websocket",
      "host": "127.0.0.1",
      "port": 3001,
      "enabled": true,
      "triggerKeyword": "渡渡鸟",
      "adminUserIds": [123456789],
      "whitelistUserIds": [],
      "privateMessagePrefix": "/",
      "groupHistorySize": 15,
      "renderMarkdownToPlain": true,
      "longMessageMode": "normal",
      "longMessageThreshold": 300
    }
  }
}

Session 策略

| 场景 | Session ID | 说明 | |------|-----------|------| | 群聊 | dodo:group:{群号} | 所有群成员共享上下文 | | 私聊 | dodo:dm:{QQ号} | 每人独立上下文 |

触发条件

| 场景 | 条件 | |------|------| | 群聊 | @渡渡鸟 或消息包含触发关键词 | | 私聊 | 直接回复（可配置前缀过滤） |

Agent 工具

AI 可调用以下工具：

| 工具 | 用途 | |------|------| | dodo_send_text | 发送文本（群/私聊） | | dodo_send_image | 发送图片 | | dodo_upload_file | 上传文件 | | dodo_get_group_msg_history | 获取群聊历史消息 | | dodo_search_group_member | 按名字搜索群成员 | | dodo_run_script | 执行自定义 JS/TS 脚本 |

内置 Skills

| Skill | 内容 | |-------|------| | jx3-factions | 剑三 20 门派体型别称、心法、服务器别称 | | dodo-rules | 管理员权限、记忆写入控制、风险行为上报、行为准则 |

License

MIT © PigeonMuyz