9.9 KiB
9.9 KiB
通讯架构总览
编制时间：2026-05-27 系统：Hermes Agent + OpenClaw Gateway 服务器：sxbh.ltd
一、整体架构图
┌──────────────────────────────────────────────────────────────────┐
│ 公网 (sxbh.ltd) │
│ :443 │
└──────────────────────────┬──────────────────────────────────────┘
│ Nginx
│
┌─────────────────────────────────┼─────────────────────────────────────┐
│ │ │
┌────────▼────────┐ ┌─────────▼─────────┐ ┌────────────▼────┐
│ /plugins/digital│ │ /plugins/wecom/ │ │ 其他站点 │
│ /{name}/ │ │ /agent/{name}/ │ │(cma/learn/...) │
└────────┬────────┘ └─────────┬─────────┘ └─────────────────┘
│ │
┌──────────┴──────────┐ ┌─────────────┴─────────────┐
▼ ▼ ▼ ▼
┌────────────┐ ┌──────────────┐ ┌─────────────────────────────────────────────┐
│ Hermes │ │ Hermes │ │ OpenClaw Node Gateway │
│ Python │ │ Python │ │ (PID 689975, :18789) │
│ Gateway #1 │... │ Gateway #6 │ │ │
│ (数字员工) │ │ (数字员工) │ │ ┌──────────┐ ┌────────┐ ┌───────────┐ │
└──────┬─────┘ └──────┬───────┘ │ │ WeCom │ │ QQ Bot│ │ Weixin │ │
│ │ │ │ (11个助理)│ │ │ │ (未配置) │ │
│ │ │ └─────┬────┘ └───┬───┘ └───────────┘ │
│ │ └───────┼────────────┼──────────────────────┘
│ │ │ │
▼ ▼ │ │
┌──────────┐ ┌──────────┐ │ │
│ Dev- │ │ Hermes │ │ │
│ Architect│ │ API │ │ │
│ Profile │ │ :8644 │◄─────────────┘ │
│ :8661 │ │ │ │
└──────────┘ └──────────┘ │
│
┌───────────┴───────────┐
│ QQ机器人群/私信 │
│ (1903900435) │
└───────────────────────┘
二、数字员工通道（Hermes Python Gateway）
每个数字员工独立运行一个 Hermes Python Gateway，通过企微自建应用的接收消息回调接收消息。
| 数字员工 | 企微AgentID | 企微应用名 | 回调路径 | Callback端口 | API端口 |
|---|---|---|---|---|---|
| 数字员工-01-架构师 | 1000031 | dev-architect | /plugins/digital/architect/wecom/callback |
8661 | 8644 |
| 数字员工-02-前端开发 | 1000032 | dev-frontend | /plugins/digital/frontend/wecom/callback |
8652 | 8647 |
| 数字员工-03-后端开发 | 1000033 | dev-backend | /plugins/digital/backend/wecom/callback |
8653 | 8645 |
| 数字员工-04-运维部署 | 1000034 | dev-ops | /plugins/digital/ops/wecom/callback |
8654 | 8649 |
| 数字员工-05-测试工程师 | 1000035 | dev-qa | /plugins/digital/qa/wecom/callback |
8655 | 8650 |
| 数字员工-06-全栈开发 | 1000036 | dev-fullstack | /plugins/digital/fullstack/wecom/callback |
8656 | 8648 |
消息流转路径：
用户微信 → 企微服务器 → Nginx(:443) → /plugins/digital/{name}/ → Hermes Python Gateway(:callback端口) → DeepSeek API → 回复
当前运行状态：6个数字员工全部 ✅ 正常运行
三、数字总控（dev-digital）
数字总控是一个特殊的 Hermes Gateway，它监听所有6个数字员工的企微回调，可做集中路由或消息分发。
| 项目 | 值 |
|---|---|
| Profile | dev-digital |
| 监听的AgentIDs | 1000031~1000036 |
| Callback端口 | 8630 |
| API端口 | 8646 |
| 回调路径 | /plugins/digital/digital/wecom/callback |
注意： dev-digital 的 callback 端口 8630 在 Nginx 中没有独立配置，如需启用需要添加 Nginx 路由。
四、总经理助理及员工助理通道（OpenClaw Node Gateway）
通过 OpenClaw Node Gateway 的 WeCom 插件，以 webhook 模式接收企微消息。
| 角色 | 企微AgentID | 企微应用名 | 模型 | 类型 |
|---|---|---|---|---|
| 总经理助理 | 1000020 | admin-ren | hermes/hermes-agent | 默认助理 |
| 助理-王婧 | 1000021 | wangjing | 默认 | 员工助理 |
| 助理-李亚玲 | 1000022 | liyaling | 默认 | 员工助理 |
| 助理-陈艳 | 1000023 | chenyan | 默认 | 员工助理 |
| 助理-董均国 | 1000024 | dongjunguo | 默认 | 员工助理 |
| 助理-蒋亚文 | 1000025 | jiangyawen | 默认 | 员工助理 |
| 助理-田顺利 | 1000026 | tianshunli | 默认 | 员工助理 |
| 助理-贾妮 | 1000027 | jiani | 默认 | 员工助理 |
| 助理-付世祥 | 1000028 | fushixiang | 默认 | 员工助理 |
| 助理-李巧玲 | 1000037 | liqiaoling | 默认 | 员工助理 |
| 助理-蒋晓荣 | 1000029 | jiangxiaorong | 默认 | 员工助理 |
消息流转路径：
用户微信 → 企微服务器 → Nginx(:443) → /plugins/wecom/agent/{name}/ → OpenClaw(:18789)
→ Hermes Agent API(:8644/v1, dev-architect profile) → DeepSeek API → 回复
总经理助理（admin-ren）默认使用 hermes/hermes-agent 模型，通过 OpenClaw 配置的 Hermes Provider (http://127.0.0.1:8644/v1) 调用 Hermes Agent API 处理。
当前运行状态：所有11个助理 ✅ 正常运行
五、QQ Bot 通道
| 项目 | 值 |
|---|---|
| Bot ID | 1903900435 |
| 通道 | OpenClaw QQBot 频道/私信/群聊 |
| 状态 | ✅ WebSocket 已连接 |
| 默认模型 | deepseek/deepseek-chat |
消息流转路径：
用户QQ → QQ Bot服务器 → WebSocket → OpenClaw(:18789) → DeepSeek API → 回复
六、微信个人号通道（wechat-renfuhai）
| 项目 | 值 |
|---|---|
| Profile | wechat-renfuhai |
| iLink账号 | 2783fe13fa99@im.bot |
| API端口 | 8651 |
| 状态 | ✅ 已连接（2026-05-27 重新扫码） |
消息流转路径：
用户微信 → iLink API → Hermes Python Gateway(:8651) → DeepSeek API → 回复
⚠️ 注意：微信个人号由独立的 Hermes Python Gateway 管理，不经过 OpenClaw。
七、辅助服务
| 服务 | 端口 | 用途 | 状态 |
|---|---|---|---|
| wecom-auth | 4180 | 企微 OAuth2 登录认证 | ✅ 运行中 |
| wecom-contact-http | 18900 | 企微通讯录 HTTP MCP 服务 | ✅ 运行中 |
| erp-gateway | 8300 | ERP 数据只读接口网关 | ✅ 运行中 |
| Nginx | 80/443 | 反向代理 / SSL 终止 | ✅ 运行中 |
八、端口总表
| 端口 | 服务 | Profile/用途 |
|---|---|---|
| 80 | Nginx HTTP | HTTP 重定向 |
| 443 | Nginx HTTPS | 主入口 |
| 18789 | OpenClaw Gateway | 企微/QQ通道 |
| 8642~8656 | 多个Hermes API | 数字员工 API Server |
| 8630 | dev-digital | 数字总控回调 |
| 8651 | wechat-renfuhai | 微信个人号 API |
| 8661 | dev-architect | 架构师回调 |
| 8652~8656 | 各数字员工 | 各数字员工回调 |
| 18900 | wecom-contact | 通讯录服务 |
| 4180 | wecom-auth | OAuth服务 |
九、已知问题 / 待办
- dev-digital 的 Nginx 路由未配置（端口8630），如果要启用数字总控的独立回调地址，需要在 Nginx 中添加
- 微信个人号 的 iLink Token 会过期，需定期重新扫码
- 系统重启后，Hermes Python Gateway 需要手动启动（未配置 systemd 服务），建议后续配置 systemd 自动启动
- Nginx 存在多个 server_name 冲突警告（sxbh.ltd 在80/443端口重复）