Deployment Components
FinClaw Microservices
| Process | Service | Port (Internal) | Notes |
|---|---|---|---|
| api-gateway | API Gateway | HTTP/26100 | The single external entrypoint — TLS termination, JWT validation, rate limiting, CSP. Used by frontends, SDK, and admin console. |
| identity-service | Identity Service | HTTP/26101 | Authentication, JWT issuance, session management, multi-tenant identity. |
| orchestrator | Flow Orchestrator | HTTP/26102 | Interprets YAML flow definitions; threads intent classification, context assembly, LLM calls, and delivery. |
| ag-ui-server | AG-UI Gateway | HTTP/26103 | AG-UI / SSE streaming gateway for chat clients. |
| persona-service | Persona Service | HTTP/26104 | Onboarding personas, role templates, persona upload management. |
| skill-service | Skill Service | HTTP/26105 | Skill catalog, installation, review, and platform-skill management. |
| openclaw-compat-gateway | OpenClaw Compatibility Gateway | HTTP/26106 | Gateway for OpenClaw-protocol compatibility. |
| claw-fleet-manager | Claw Fleet Manager | HTTP/26107 | Lifecycle management of claw runtime instances. |
| conversation-store | Conversation Store | HTTP/26200 | WORM append-only conversation store on TimescaleDB + NATS. |
| delivery | Delivery Service | HTTP/26201 | Delivery coordinator across inbox / SSE / push. |
| inbox-service | Inbox Service | HTTP/26202 | Reliable inbox storage. |
| push-service | Push Service | HTTP/26203 | Push notifications via APNs / vendor channels. |
| document-service | Document Service | HTTP/26205 | Document API backed by workspace volumes. |
| ai-infra-rs | AI Runtime | HTTP/26450 | Main AI backend (Rust) — inference, tool invocation, memory, scheduling hooks. |
| feishu-connector | Feishu Connector | HTTP/26460 | Feishu / Lark channel connector. |
| doc-toolkit | Document Toolkit Worker | HTTP/26461 | Resident document processing (fetch / extract / validate / export). |
Infrastructure Services
| Process | Service | Port (Internal) | Notes |
|---|---|---|---|
| postgres | Relational DB | TCP/26110 | PostgreSQL — platform schemas (identity / inbox / persona / skill / document / pulse, etc.). |
| timescaledb | Time-Series DB | TCP/26111 | TimescaleDB — conversation-store history. |
| nats | Message Bus | TCP/26112, 26113 | NATS JetStream — cross-service events and reliable delivery; 26113 is monitoring UI/API. |
| redis | Cache & Coordination | TCP/26114 | Caching, coordination state, rate-limit counters. |
| tei | Text Embeddings | HTTP/26117 | Text Embeddings Inference — vector generation. |
| restate | Workflow Engine | HTTP/26180, 26181 | Durable timers and cron for ai-infra-rs; 26181 is admin API. |
| qdrant | Vector Search (optional) | HTTP/6333, gRPC/6334 | Vector store, enabled by runtime on demand. |
Operations Infrastructure
| Name | Category | Port | Description |
|---|---|---|---|
| CentOS 8+ / RHEL 8+ / Ubuntu 22.04+ | Operating System | — | Base OS, X86_64. Evaluate against the matching RHEL/Ubuntu baseline for domestic Linux distributions. |
| Docker Engine 24+ | Container Engine | — | All services run as Docker containers in single-machine mode. |
| Docker Compose v2 | Container Orchestration | — | Single-machine mode uses docker-compose.yml + fleet.sh. |
| Prometheus / Grafana | Monitoring | Internal / multiple | Optional — dashboards and alerting. |
| Vector + Kafka + ES + Kibana / Loki + Grafana | Logging | Internal / multiple | Optional — cluster-scale log aggregation. |
Request Paths
- Inbound conversation (Flow A):
api-gateway → ag-ui-server → orchestrator → ai-infra-rs → delivery → (inbox-service / push-service / AG-UI stream)
See Architecture Overview for the overall architecture and deployment modes.