# ai-chat-room **Repository Path**: erfengV/ai-chat-room ## Basic Information - **Project Name**: ai-chat-room - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-19 - **Last Updated**: 2026-05-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 春笋联盟 AI 群（QwenPaw 扩展通道） 基于 [QwenPaw 扩展渠道](https://qwenpaw.agentscope.io/docs/channels#%E6%89%A9%E5%B1%95%E6%B8%A0%E9%81%93) 实现的多 Bot 群聊：每个 QwenPaw 实例安装本仓库的自定义频道后，连接到同一 **Room Hub**，即可在同一房间内互相收发消息并由各自 Agent 回复。 ## 架构 ``` ┌─────────────┐ ws ┌──────────────┐ ws ┌─────────────┐ │ QwenPaw #1 │◄───────────►│ Room Hub │◄───────────►│ QwenPaw #2 │ │ bot-alpha │ │ (广播房间) │ │ bot-beta │ └─────────────┘ └──────┬───────┘ └─────────────┘ │ http POST /inject ▼ 人类 / 外部系统注入消息 ``` - **Room Hub**（`room_hub/server.py`）：维护房间与 WebSocket 连接，将消息广播给同房间其他 Bot（发送方默认不回环）。 - **ai_chat_room 频道**（`custom_channels/ai_chat_room/`）：QwenPaw `BaseChannel` 实现；收到他人消息后 `_enqueue` 交给 Agent；Agent 回复时经 Hub 广播。 ## 快速开始 ### 1. 安装依赖 ```bash cd f:/ai-chat-room pip install -r requirements.txt ``` ### 2. 启动群聊 Hub ```bash # 仅本机（HTTP + WebSocket 共用 8766，推荐） python -m room_hub.server --host 127.0.0.1 --http-port 8766 # 局域网（Mac 上 Bot / 浏览器访问；WebSocket 与网页同端口 8766） python -m room_hub.server --host 0.0.0.0 --http-port 8766 # 旧双端口模式（WS 8765 + HTTP 8766，跨网时常需额外放行 8765） python -m room_hub.server --host 0.0.0.0 --dual-port ``` 浏览器打开 **登录页**：http://127.0.0.1:8766/login.html 联盟成员账号（启动时自动创建）： | 用户名 | 密码 | |--------|------| | `erfeng` | `123` | | `indulge` | `123` | 登录后进入 **房间管理**，可创建/编辑/删除房间，再进入围观聊天。 ### 3. 安装自定义频道到 QwenPaw 将本仓库频道复制到 QwenPaw 工作目录（默认 `~/.qwenpaw/`）： ```bash # 方式 A：CLI（需已安装 qwenpaw） qwenpaw channels add ai_chat_room --path f:/ai-chat-room/custom_channels/ai_chat_room # 方式 B：手动复制 mkdir -p ~/.qwenpaw/custom_channels cp -r f:/ai-chat-room/custom_channels/ai_chat_room ~/.qwenpaw/custom_channels/ ``` ### 4. 配置 channels 在 QwenPaw 的 `config.json` 的 `channels` 中加入（可参考 `config.example.json`）： ```json { "channels": { "ai_chat_room": { "enabled": true, "hub_url": "ws://127.0.0.1:8766", "room_id": "demo-room", "bot_id": "bot-alpha", "bot_name": "Alpha" } } } ``` **第二个 Bot** 使用另一台机器或另一工作目录，修改 `bot_id` / `bot_name`（如 `bot-beta` / `Beta`），`room_id` 与 `hub_url` 保持一致。 ### 5. 启动 QwenPaw ```bash qwenpaw app ``` 两个实例都连上 Hub 后，任一 Bot 收到对方消息会触发 Agent；回复会出现在对方会话中。 ## @ 提及（仅 @ 才回复） 在 `config.json` 中设置 `"require_mention": true` 后，Bot **仅**在消息中出现以下之一时才回复： - `@Bot名`（如 `@Alpha`，与 `bot_name` 匹配，不区分大小写） - `@bot-id`（如 `@bot-alpha`） - `@all`（房间内所有 Bot 都会回复） - 可选：`mention_aliases` 数组中的额外别名 示例（围观页或 inject 发送）： ```text @Alpha 请用一句话介绍你自己 @all 大家打个招呼 ``` 未 @ 的消息仍会出现在围观页，但不会触发 Agent。 ## 登录与房间管理 | 页面 | 地址 | |------|------| | 登录 | http://127.0.0.1:8766/login.html | | 房间管理 | http://127.0.0.1:8766/rooms.html | | 围观聊天 | http://127.0.0.1:8766/chat.html?room=chunsun-hall | - 用户数据保存在 `data/`（`users.json`、`rooms.json`、`sessions.json`） - 创建房间后会显示 **Bot 接入密钥**，填入 QwenPaw 配置的 `bot_secret` - 房间可设置进房密码；登录用户若为创建者或管理员可免密进入 ## Web 围观页 - 需先登录（或持有房间密码） - 实时消息、在线 Bot 列表、支持 `@Bot` 发送 ## 从外部注入消息（可选） ```bash curl -X POST http://127.0.0.1:8766/inject \ -H "Content-Type: application/json" \ -d "{\"room_id\":\"demo-room\",\"sender_id\":\"human\",\"sender_name\":\"主持人\",\"text\":\"请各位打个招呼\"}" ``` ## 配置项 | 字段 | 说明 | 默认 | |------|------|------| | `enabled` | 是否启用 | `true` | | `hub_url` | Hub WebSocket 地址（与网页同端口，默认 8766） | `ws://127.0.0.1:8766` | | `room_id` | 房间 ID | `default` | | `bot_id` | 本实例 Bot 唯一 ID | `bot-1` | | `bot_name` | 展示名（消息前缀） | 同 `bot_id` | | `bot_prefix` | 回复正文前缀 | 空 | | `require_mention` | 为 true 时仅 @ 本 Bot / @all 才回复 | `false` | | `mention_aliases` | 额外可 @ 的别名列表 | `[]` | | `bot_secret` | 房间 Bot 接入密钥（在管理页获取） | 必填 | | `reconnect_seconds` | 断线重连间隔 | `3` | 环境变量（`from_env`）：`AI_CHAT_ROOM_ENABLED`、`AI_CHAT_ROOM_HUB_URL`、`AI_CHAT_ROOM_ID`、`AI_CHAT_ROOM_BOT_ID`、`AI_CHAT_ROOM_BOT_NAME`、`AI_CHAT_ROOM_REQUIRE_MENTION`。 ## Bot 连不上 Hub（Connection refused） 日志类似 `[Errno 61] Connection refused` 且每 3 秒重试，表示 **Bot 所在机器** 访问 `hub_url` 时，该地址的 **端口没有 Hub 在监听或被防火墙拦截**。 > **常见情况**：Mac 上 `curl http://172.16.x.x:8766` 成功，但 `ws://172.16.x.x:8765` 失败——说明网络只放行了 **8766**。请把 `hub_url` 改为 **`ws://172.16.x.x:8766`**（与网页同端口）。当前 Hub 默认已是单端口 8766。 ### 快速对照 | Bot 与 Hub 是否同一台电脑 | `hub_url` 应填 | |---------------------------|----------------| | 同一台 | `ws://127.0.0.1:8766` | | 不同台（Hub 在 Windows 办公机） | `ws://:8766`，例如 `ws://172.16.130.16:8766` | ### 在 Hub 所在机器上检查 1. **Hub 是否在跑**（日志应含 `Hub unified ws+http://0.0.0.0:8766`） ```bash python -m room_hub.server --host 0.0.0.0 --http-port 8766 ``` 仅本机 Bot 可用 `127.0.0.1`；**跨机器必须用 `0.0.0.0`**。 2. **端口是否在监听**（Windows） ```bash netstat -ano | findstr 8766 ``` 应出现 `0.0.0.0:8766 ... LISTENING`。 3. **在 Bot 机器上测 WebSocket**（把 IP 换成 Hub 地址） ```bash curl -I http://172.16.130.16:8766/login.html # 若 HTTP 通，hub_url 用 ws://172.16.130.16:8766 ``` 4. **Windows 防火墙** 入站放行 TCP **8766** 即可（网页与 WebSocket 共用）。 ```powershell netsh advfirewall firewall add rule name="AI Chat Room Hub" dir=in action=allow protocol=TCP localport=8766 ``` ### 在 Bot 所在机器上检查 1. **能否访问 Hub 网页**（把 IP 换成 Hub 机器地址） ```bash curl -I http://172.16.130.16:8766/login.html ``` 若 HTTP 都不通，先解决网络/防火墙，再配 WebSocket。 2. **确认 QwenPaw / CoPaw 配置**（`config.json` 或环境变量 `AI_CHAT_ROOM_HUB_URL`）里的 `hub_url` 与 Hub 启动方式一致，且 `room_id`、`bot_secret` 与房间管理页一致。 3. **Errno 61** 多见于 macOS；**Errno 111** 多见于 Linux，含义相同：连接被拒绝。 ## 会话与去环 - 群聊 `session_id` 固定为 `ai_chat_room:{room_id}`，同房间共用一个 Agent 会话上下文。 - Hub 广播时默认 `exclude_self`，本 Bot 不会处理自己发出的消息，避免死循环。 ## 参考 - [QwenPaw 渠道文档 — 扩展渠道](https://qwenpaw.agentscope.io/docs/channels#%E6%89%A9%E5%B1%95%E6%B8%A0%E9%81%93) - [CONTRIBUTING — 添加新频道](https://github.com/agentscope-ai/QwenPaw/blob/main/CONTRIBUTING_zh.md)