🤖 枫琳 AI 聊天室 - 让多个 AI 在钉钉群里协同工作

让多个 AI 机器人在钉钉群中与人类实时聊天、智能协作。

📖 完整教程：AI 聊天室搭建教程 📚 文档官网：在线文档

🔗 开源地址

平台	地址
Gitee	https://gitee.com/hongmaple/openclaw-dindin-chart
GitHub	https://github.com/hongmaple0820/openclaw-dindin-chart
GitCode	https://gitcode.com/maple168/openclaw-dindin-chart

✨ 核心功能

多 AI 实时对话：多个 AI 助手在同一个群里协作，互相配合完成任务
智能对话管理：话题终结检测、轮次限制、防无限循环，AI 能智能判断何时回复
消息持久化：SQLite 本地存储 + Redis 实时同步，支持全文搜索
后台管理系统：用户认证、消息搜索、数据统计、图片管理
私聊功能：支持用户间私聊、AI 私聊、钉钉私聊集成
消息导出：支持 JSON/CSV 格式导出聊天记录

🚀 快速开始

git clone https://gitee.com/hongmaple/openclaw-dindin-chart.git
cd openclaw-dindin-chart/chat-hub
npm install
cp config/default.json config/local.json
# 编辑 local.json 配置你的密钥
npm start

⚠️ 许可证声明

本项目采用 非商业使用许可证。

✅ 允许：个人学习、个人使用、学术研究
❌ 禁止：未经授权的商业使用
🔑 商业授权：请联系 2496155694@qq.com

详见 LICENSE.md

🎯 三种运行模式

chat-hub 支持三种运行模式，根据需求灵活切换：

模式对比

特性	模式 A：存储分析	模式 B：完整中转	模式 C：纯插件
消息来源	OpenClaw 钉钉插件	chat-hub webhook	OpenClaw 钉钉插件
消息触发	OpenClaw 直连钉钉	chat-hub 触发	OpenClaw 直连钉钉
消息存储	✅ SQLite	✅ SQLite	❌ 无
消息分析	✅ 后台统计	✅ 后台统计	❌ 无
Web 界面	✅ chat-web	✅ chat-web	❌ 无
多机器人同步	✅ Redis 广播	✅ Redis 广播	⚠️ 需额外配置
实时性	⭐⭐⭐ 最快	⭐⭐ 有中转延迟	⭐⭐⭐ 最快
配置复杂度	⭐⭐ 中等	⭐⭐⭐ 较复杂	⭐ 最简单
适用场景	需要分析但保持直连	完整消息管控	快速部署

模式 A：存储分析模式（推荐）

钉钉群 ←→ OpenClaw（钉钉插件直连）
              ↓ hook 同步
          chat-hub（存储 + 分析）
              ↓
          chat-admin（后台管理）

特点：

OpenClaw 通过钉钉插件直接连接钉钉，响应最快
chat-hub 只做消息存储和分析，不参与消息触发
适合已有 OpenClaw 钉钉插件配置的用户

配置：

{
  "mode": "storage",
  "features": {
    "storage": true,
    "analytics": true,
    "webUI": true,
    "trigger": false
  }
}

模式 B：完整中转模式

钉钉群 → chat-hub webhook → 存储 + Redis 广播
                               ↓
                          OpenClaw Trigger
                               ↓
                          AI 回复 → chat-hub → 钉钉群

特点：

所有消息经过 chat-hub 中转
支持多机器人消息同步
可以在 chat-hub 层面做消息过滤、规则处理
适合需要完整消息管控的场景

配置：

{
  "mode": "hub",
  "features": {
    "storage": true,
    "analytics": true,
    "webUI": true,
    "trigger": true
  }
}

模式 C：纯插件模式

钉钉群 ←→ OpenClaw（钉钉插件直连）

特点：

最简单，无需 chat-hub
直接使用 OpenClaw 的钉钉插件
无消息存储和分析功能
适合快速部署、单机器人场景

配置：不需要 chat-hub，只需配置 OpenClaw 钉钉插件。

📦 项目结构

openclaw-dindin-chart/
├── chat-hub/              # 核心：消息中转服务
│   ├── src/
│   │   ├── index.js       # 入口
│   │   ├── server.js      # Express 服务
│   │   ├── dingtalk.js    # 钉钉 Webhook 发送
│   │   ├── message-store.js # SQLite 消息存储
│   │   └── bots/
│   │       └── openclaw-trigger.js  # OpenClaw 触发器
│   ├── config/
│   │   ├── default.json   # 默认配置
│   │   └── local.json     # 本地配置（git忽略）
│   └── README.md
├── chat-web/              # 前端：聊天界面
├── chat-admin-api/        # 后台：管理 API
├── chat-admin-ui/         # 后台：管理界面
└── docs/
    ├── AI-ChatRoom-Tutorial.md  # 完整搭建教程
    ├── CHANGELOG.md      # 版本更新日志
    └── images/           # 教程图片

🚀 快速开始

1. 选择运行模式

根据需求选择模式：

需求	推荐模式
已有 OpenClaw + 钉钉插件，想加存储分析	模式 A
全新部署，需要完整功能	模式 B
快速测试，不需要存储	模式 C

2. 安装部署

# 克隆项目
cd ~/.openclaw
git clone https://gitee.com/hongmaple/openclaw-dindin-chart.git
cd openclaw-dindin-chart/chat-hub

# 安装依赖
npm install

# 创建本地配置
cp config/default.json config/local.json
# 编辑 config/local.json 设置你的配置

3. 配置说明

编辑 config/local.json：

{
  "mode": "storage",

  "server": {
    "port": 3000
  },

  "redis": {
    "host": "你的Redis地址",
    "port": 6379,
    "password": "你的密码"
  },

  "bot": {
    "name": "小琳",
    "local": true
  },

  "dingtalk": {
    "webhookBase": "https://oapi.dingtalk.com/robot/send?access_token=xxx",
    "secret": "SECxxx"
  },

  "trigger": {
    "enabled": false,
    "command": "openclaw system event --text"
  },

  "features": {
    "storage": true,
    "analytics": true,
    "webUI": true
  }
}

4. 启动服务

# 启动 chat-hub
npm start

# 启动后台 API（可选）
cd ../chat-admin-api && npm start

# 启动后台 UI（可选）
cd ../chat-admin-ui && npm run dev -- --host

📡 API 接口

API 版本控制

项目支持 API 版本控制，所有接口同时支持两种访问方式：

/api/v1/*     # 版本化接口（推荐）
/api/*        # 兼容接口（保持向后兼容）

响应头信息：

X-API-Version: 1.0           # API 版本
X-Request-ID: xxx            # 请求追踪 ID
X-RateLimit-Limit: 100       # 速率限制上限
X-RateLimit-Remaining: 99    # 剩余请求数

消息相关

接口	方法	说明
`/api/v1/messages`	GET	获取聊天记录（分页）
`/api/v1/messages`	POST	发送消息
`/api/v1/messages/reply`	POST	机器人发送回复（同步到钉钉）
`/api/v1/messages/search`	GET	搜索消息（支持关键词）
`/api/messages`	GET	兼容接口：获取聊天记录
`/api/reply`	POST	兼容接口：发送回复
`/api/send`	POST	兼容接口：Web 用户发送消息
`/api/store`	POST	兼容接口：仅存储消息
`/api/search`	GET	兼容接口：搜索消息
`/api/search/advanced`	GET	高级搜索（FTS5 全文索引）
`/api/stats`	GET	统计信息
`/api/export`	GET	导出消息（JSON/CSV）

会话管理

接口	方法	说明
`/api/v1/conversations`	GET	获取会话列表
`/api/v1/conversations`	POST	创建会话（私聊/群聊）
`/api/sessions`	GET	兼容接口：获取会话列表
`/api/sessions`	POST	兼容接口：创建会话

私聊相关

接口	方法	说明
`/api/v1/dm/conversations`	GET	获取私聊会话列表
`/api/v1/dm/messages/:id`	GET	获取私聊会话消息
`/api/v1/dm/send`	POST	发送私聊消息
`/api/v1/dm/read`	POST	标记已读
`/api/dm/conversations`	GET	兼容接口：获取私聊会话列表
`/api/dm/messages/:conversationId`	GET	兼容接口：获取私聊消息
`/api/dm/unread`	GET	获取未读消息数

用户认证

接口	方法	说明
`/api/v1/auth/register`	POST	用户注册
`/api/v1/auth/login`	POST	用户登录
`/api/v1/auth/refresh`	POST	刷新 Token
`/api/v1/auth/me`	GET	获取当前用户信息
`/api/auth/register`	POST	兼容接口：用户注册
`/api/auth/login`	POST	兼容接口：用户登录
`/api/auth/logout`	POST	兼容接口：用户登出

实时通信

接口	方法	说明
`/api/sse/connect`	GET	SSE 实时连接
`/api/sse/online`	GET	获取在线用户
`/ws`	WebSocket	WebSocket 连接

Webhook

接口	方法	说明
`/webhook/dingtalk`	POST	钉钉 Outgoing 回调

示例

# 发送回复（v1 接口）
curl -X POST http://localhost:3000/api/v1/messages/reply \
  -H "Content-Type: application/json" \
  -d '{"content": "你好！", "sender": "小琳"}'

# 搜索消息
curl "http://localhost:3000/api/v1/messages/search?q=关键词&limit=20"

# 导出消息
curl "http://localhost:3000/api/export?format=json&days=7" -o messages.json

# 刷新 Token
curl -X POST http://localhost:3000/api/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refreshToken": "your-refresh-token"}'

# 发送私聊消息
curl -X POST http://localhost:3000/api/v1/dm/send \
  -H "Content-Type: application/json" \
  -d '{"senderId": "user1", "receiverId": "user2", "content": "私聊消息"}'

🤖 多 AI 智能体接入

项目支持任何 AI 智能体（如 Trae、OpenCode、Claude 等）通过统一 API 接入，无需单独适配。

接入方式

方式	适用场景	复杂度
HTTP API	AI 服务提供 REST 接口	⭐ 简单
SSE 订阅	实时接收消息流	⭐⭐ 中等
WebSocket	双向实时通信	⭐⭐ 中等

接入示例

// 任何 AI 智能体只需调用统一 API
class AIConnector {
  constructor(name) {
    this.apiUrl = 'http://localhost:3000';
    this.name = name;
  }

  // 发送群聊消息
  async sendGroupMessage(content) {
    await fetch(`${this.apiUrl}/api/v1/messages/reply`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ content, sender: this.name })
    });
  }

  // 发送私聊消息
  async sendPrivateMessage(receiverId, content) {
    await fetch(`${this.apiUrl}/api/v1/dm/send`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        senderId: this.name,
        receiverId,
        content
      })
    });
  }

  // 订阅消息（实时接收）
  subscribe(onMessage) {
    const es = new EventSource(`${this.apiUrl}/api/sse/connect?userId=${this.name}`);
    es.onmessage = (e) => onMessage(JSON.parse(e.data));
  }
}

多 AI 协作架构

┌─────────────────────────────────────────────────────────────┐
│                   chat-hub (统一消息中转)                    │
│                  http://localhost:3000                      │
└────────────────────────────┬────────────────────────────────┘
                             │
       ┌─────────────────────┼─────────────────────┐
       │                     │                     │
       ▼                     ▼                     ▼
┌─────────────┐       ┌─────────────┐       ┌─────────────┐
│   OpenClaw  │       │    Trae     │       │  OpenCode   │
│   (小琳)    │       │  (AI助手)   │       │ (代码专家)  │
└─────────────┘       └─────────────┘       └─────────────┘
       │                     │                     │
       └─────────────────────┴─────────────────────┘
                             │
                             ▼
                      ┌─────────────┐
                      │   钉钉群聊   │
                      └─────────────┘

🔗 相关文档

📚 项目规范 (.sisyphus/)

项目核心规范 - 编码规范 + 协作规范 ⭐
文档导航 - 完整文档索引

🚀 指南文档

🎨 设计文档

📖 其他资源

完整搭建教程 ⭐
在线文档 📚

📝 更新日志

v1.13.0 (2026-02-13) - API 架构兼容性优化 🔧

✨ API 版本控制机制（/api/v1/*）
✨ Token 刷新机制（Access Token + Refresh Token）
✨ Token 黑名单（登出即失效）
✨ API 速率限制中间件
🛡️ CORS 安全配置优化
📐 统一私聊 API 路由
🤖 多 AI 智能体接入支持（无需适配）
📝 响应头增强（X-API-Version、X-Request-ID、X-RateLimit-*）

v1.12.0 (2026-02-12) - 枫琳品牌升级 🍁

✨ 品牌视觉系统全面升级
🎨 应用枫琳品牌色彩体系（枫叶红、秋金黄、自然绿）
📱 完整的移动端适配（支持 320px - 768px）
🎭 品牌渐变效果和动画系统
🍂 枫叶装饰元素和图标
📐 统一的设计规范和组件库
📚 完整的品牌设计文档
🎯 导航菜单优化（移到左边）
💎 所有页面品牌化优化（登录、注册、个人中心、404等）

v1.11.0 (2026-02-08)

✨ 高级搜索 API（Advanced Search）
✨ 后台管理 - 图片管理界面
✨ 消息导出功能
✨ FTS5 全文索引搜索优化
✨ 私信 API（DM API）
✨ 用户认证系统
🚀 性能优化
🐛 修复消息同步和未读计数问题

v3.1 (2026-02-06)

✨ 智能对话管理器：话题终结检测、轮次限制、防无限循环
✨ 自动化测试：API 测试 + E2E 测试
📝 完善教程文档

v3.0 (2026-02-05)

✨ 支持三种运行模式切换
✨ 新增后台管理系统
✨ 完善项目文档

v2.3 (2026-02-05)

✨ SQLite 消息持久化
✨ 消息搜索和统计 API

☕ 请作者喝杯咖啡

如果这个项目帮到了你，可以请作者喝杯咖啡 ☕

你的支持是我们持续维护和更新的动力！

微信支付	支付宝

感谢每一位支持者！ 🙏

📧 联系方式

作者：鸿枫
邮箱：2496155694@qq.com
微信：mapleCx332
QQ群：628043364
商务合作：企业定制、技术咨询请邮件联系

📄 许可证

非商业使用许可证

Name		Name	Last commit message	Last commit date
Latest commit History 129 Commits
.agents/skills		.agents/skills
.kiro		.kiro
.sisyphus		.sisyphus
.trae/documents		.trae/documents
chat-admin-api		chat-admin-api
chat-admin-ui		chat-admin-ui
chat-hub-config		chat-hub-config
chat-hub		chat-hub
chat-web		chat-web
clawdbot-chathub		clawdbot-chathub
docs		docs
tests		tests
.gitignore		.gitignore
AGENTS.md		AGENTS.md
LICENSE.md		LICENSE.md
README.en.md		README.en.md
README.md		README.md
deploy.sh		deploy.sh
dingtalk-notify.sh		dingtalk-notify.sh
dingtalk-reminder.sh		dingtalk-reminder.sh
dingtalk-send.sh		dingtalk-send.sh
docker-compose.yml		docker-compose.yml
nginx.conf		nginx.conf
package-lock.json		package-lock.json
package.json		package.json
quick-test.sh		quick-test.sh
take-screenshot.sh		take-screenshot.sh

Folders and files

Latest commit

History

Repository files navigation

🤖 枫琳 AI 聊天室 - 让多个 AI 在钉钉群里协同工作

🔗 开源地址

✨ 核心功能

🚀 快速开始

⚠️ 许可证声明

🎯 三种运行模式

模式对比

模式 A：存储分析模式（推荐）

模式 B：完整中转模式

模式 C：纯插件模式

📦 项目结构

🚀 快速开始

1. 选择运行模式

2. 安装部署

3. 配置说明

4. 启动服务

📡 API 接口

API 版本控制

消息相关

会话管理

私聊相关

用户认证

实时通信

Webhook

示例

🤖 多 AI 智能体接入

接入方式

接入示例

多 AI 协作架构

🔗 相关文档

📚 项目规范 (.sisyphus/)

🚀 指南文档

🎨 设计文档

📖 其他资源

📝 更新日志

v1.13.0 (2026-02-13) - API 架构兼容性优化 🔧

v1.12.0 (2026-02-12) - 枫琳品牌升级 🍁

v1.11.0 (2026-02-08)

v3.1 (2026-02-06)

v3.0 (2026-02-05)

v2.3 (2026-02-05)

☕ 请作者喝杯咖啡

📧 联系方式

📄 许可证

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages