部署组件
FinClaw 微服务
| 进程 | 服务 | 端口（内部） | 备注 |
|---|---|---|---|
| api-gateway | API 网关 | HTTP/26100 | 唯一对外端口，负责 TLS 终止、JWT 校验、限流、CSP；前端、SDK、管理端的统一入口。 |
| identity-service | 身份服务 | HTTP/26101 | 提供认证、JWT 签发、会话管理与多租户身份。 |
| orchestrator | 流程编排 | HTTP/26102 | 解释 YAML 流程定义，串联意图分类、上下文组装、LLM 调用与投递。 |
| ag-ui-server | AG-UI 网关 | HTTP/26103 | 面向聊天客户端的 AG-UI / SSE 流式网关。 |
| persona-service | 画像服务 | HTTP/26104 | 引导画像、角色模板、画像上传管理。 |
| skill-service | 技能服务 | HTTP/26105 | 技能目录、安装、审核与平台技能管理。 |
| openclaw-compat-gateway | OpenClaw 兼容网关 | HTTP/26106 | 兼容 OpenClaw 协议的入口网关。 |
| claw-fleet-manager | claw 运行时管理 | HTTP/26107 | 管理 claw 运行时实例的生命周期。 |
| conversation-store | 会话存储 | HTTP/26200 | 基于 TimescaleDB + NATS 的会话追加存储（WORM）。 |
| delivery | 投递服务 | HTTP/26201 | 跨 inbox / SSE / push 的投递协调器。 |
| inbox-service | 收件箱服务 | HTTP/26202 | 可靠消息收件箱存储。 |
| push-service | 推送服务 | HTTP/26203 | APNs / 厂商通道推送通知投递。 |
| document-service | 文档服务 | HTTP/26205 | 基于工作区卷的文档 API。 |
| ai-infra-rs | AI 运行时 | HTTP/26450 | 推理、工具调用、记忆、调度钩子的主 AI 后端（Rust）。 |
| feishu-connector | 飞书连接器 | HTTP/26460 | 飞书 / Lark 渠道接入。 |
| doc-toolkit | 文档工具 worker | HTTP/26461 | 常驻文档处理（抓取 / 抽取 / 校验 / 导出）。 |
基础服务
| 进程 | 服务 | 端口（内部） | 备注 |
|---|---|---|---|
| postgres | 关系数据库 | TCP/26110 | PostgreSQL，承载平台 schema（identity / inbox / persona / skill / document / pulse 等）。 |
| timescaledb | 时序数据库 | TCP/26111 | TimescaleDB，承载 conversation-store 会话历史。 |
| nats | 消息总线 | TCP/26112、26113 | NATS JetStream，跨服务事件与可靠投递；26113 为监控 UI/API。 |
| redis | 缓存与协调 | TCP/26114 | 缓存、协调状态、限流计数。 |
| tei | 文本嵌入 | HTTP/26117 | Text Embeddings Inference，向量生成。 |
| restate | 工作流引擎 | HTTP/26180、26181 | ai-infra-rs 持久化定时器与 cron；26181 为管理 API。 |
| qdrant | 向量检索（可选） | HTTP/6333、gRPC/6334 | 运行时按需启用的向量存储。 |
运维设施
| 名称 | 分类 | 端口 | 介绍 |
|---|---|---|---|
| CentOS 8+ / RHEL 8+ / Ubuntu 22.04+ | 操作系统 | — | 基础操作系统，X86_64；信创需评估对应 RHEL/Ubuntu 基线。 |
| Docker Engine 24+ | 容器引擎 | — | 单机模式所有服务通过 Docker 容器运行。 |
| Docker Compose v2 | 容器编排 | — | 单机模式用 docker-compose.yml + fleet.sh 统一编排。 |
| Prometheus / Grafana | 监控系统 | 内部 / 多端口 | 可选，监控面板与告警。 |
| Vector + Kafka + ES + Kibana / Loki + Grafana | 日志系统 | 内部 / 多端口 | 可选，集群规模化日志聚合。 |
请求路径
- 入站对话（Flow A）：
api-gateway → ag-ui-server → orchestrator → ai-infra-rs → delivery →（inbox-service / push-service / AG-UI 流）
整体架构与部署模式见 架构说明。