部署组件
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 | 技能目录、安装、审核与平台技能管理。 |
| claw-fleet-manager | claw 运行时管理 | HTTP/26107 + 动态 26463-26549 | 管理 claw 运行时实例的生命周期；动态端口段由 per_tenant_instance 通过 docker run -p 占用，claw-fleet-manager 自身不在 compose 中映射该段。默认栈成员（identity-service 与 ai-infra-rs 依赖其路由端点）；profile 标签仅为单服务显式启动保留。 |
| a2a-gateway | A2A 网关 | HTTP/26108 | A2A 协议入口，对接外部 Agent 互联场景。 |
| auth-fabric-proxy | 认证代理 | HTTP/26109 | profile gated（auth-fabric profile），前置认证代理。 |
| 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 + 26451 | 推理、工具调用、记忆、调度钩子的主 AI 后端（Rust）；26451 为 Restate endpoint，供 Restate Server 回调 handler。 |
| searxng | 元搜索引擎 | HTTP/26118 | SearXNG 元搜索，为 ai-infra-rs 提供网页搜索（AI_INFRA_RS_WEB_SEARCH_SEARXNG_URL / _LANGUAGE）；healthcheck 路径为 /healthz。 |
| feishu-connector | 飞书连接器 | HTTP/26460 | 飞书 / Lark 渠道接入。 |
| dingtalk-connector | 钉钉连接器 | HTTP/26462 | 钉钉 Stream Mode 渠道接入。 |
| doc-toolkit | 文档工具 worker | HTTP/26461 | 常驻文档处理（抓取 / 抽取 / 校验 / 导出）。 |
| wecom-connector | 企业微信连接器 | HTTP/26550 | 企业微信渠道接入。 |
| auth-fabric | 认证服务 | HTTP/26115 | profile gated（auth-fabric profile），提供企业认证能力。 |
基础服务
| 进程 | 服务 | 端口（内部） | 备注 |
|---|---|---|---|
| postgres | 关系数据库 | TCP/26110 | PostgreSQL，承载平台 schema（identity / inbox / persona / skill / document 等）。 |
| 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。 |
K8s 端口差异：restate 在 Docker Compose 与 Kubernetes 默认值不同——compose 为
26180（ingress）/26181（admin），K8s 默认为26180（ingress）/26182（admin）。
运维设施
| 名称 | 分类 | 端口 | 介绍 |
|---|---|---|---|
| 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 | 日志系统 | 内部 / 多端口 | 可选，集群规模化日志聚合。 |
请求路径
- 入站对话：
api-gateway -> ag-ui-server -> orchestrator -> ai-infra-rs -> delivery ->（inbox-service / push-service / AG-UI 流）
整体架构与部署模式见 架构说明。
端口规划注意事项
claw-fleet-manager动态占用26463-26549端口段，防火墙与 K8s NodePort 规划需预留；该段由 per_tenant_instance 通过docker run -p <port>:<port>占用，compose 中不显式映射。- restate 端口在 Docker Compose 与 K8s 默认值不同（compose
26180/26181，K8s26180/26182）。 ai-infra-rs同时监听26450（主服务）与26451（Restate endpoint），二者均需在防火墙与 K8s Service 中放行。dingtalk-connector（26462）采用 Stream Mode，需保证与钉钉开放平台的长连通性；wecom-connector（26550）、feishu-connector（26460）按各渠道回调要求放行。