A comprehensive technical reference for the 6-layer microservice architecture of Teamgram Server, designed for developers building Telegram-compatible messaging systems.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install teamgram-architecture
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install teamgram-architecture using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Teamgram Server Architecture Guide?
This skill provides a deep-dive into the Teamgram Server architecture, a high-performance, Telegram/MTProto compatible backend. It outlines a sophisticated 6-layer system leveraging go-zero, gRPC, and Kafka for scalable messaging. By integrating this knowledge into your AI agent via Openclaw Skills, you gain immediate access to the structural blueprints of 11 core services, ranging from session management to media handling and distributed file systems.
Teamgram Server Architecture Guide Use Cases
- Understanding the gRPC and Kafka communication flow within a Telegram-compatible backend.
- Mapping microservice responsibilities for developers contributing to the Teamgram Server ecosystem.
- Designing scalable messaging architectures based on the MTProto protocol.
- Debugging service discovery issues and identifying critical etcd keys for system orchestration.
How Teamgram Server Architecture Guide Works
- The AI agent accesses the architectural schema provided by the Openclaw Skills framework to understand the system layout.
- It identifies the specific layer—Entry, Session, BFF, Core Biz, Messaging, or Sync—relevant to the developer's query.
- The skill provides service-specific details including gRPC ports, etcd discovery keys, and Kafka topic interactions.
- It maps the MTProto traffic lifecycle from the gateway through the aggregation layer to the business logic and storage tiers.
Teamgram Server Architecture Guide Setup
As a documentation-only asset within the Openclaw Skills ecosystem, no binary installation or executable environment is required. Developers should use this as a primary reference for architectural planning and microservice implementation.
# To explore the source code referenced by this skill:
git clone https://github.com/teamgram/teamgram-server
Teamgram Server Architecture Guide Data Schema & Taxonomy
The architecture is organized into a hierarchical taxonomy of services and protocols:
| Component | Protocol / Technology | Discovery Key |
|---|---|---|
| Gateway Layer | MTProto (TCP/WS/HTTP) | interface.gateway |
| Session Layer | gRPC / Session Aggregation | interface.session |
| Business Logic | BFF / 27 RPC Modules | bff.bff |
| Core Services | User/Chat/Dialog Helpers | service.biz_service |
| Messaging | Kafka (Inbox-T / Sync-T) | messenger.msg |
| Storage | Minio / DFS | service.dfs |
Teamgram Server Architecture Guide Advanced Features
- Detailed MTProto protocol mapping across distributed microservices.
- Asynchronous fanout and push path logic using Kafka Sync-T for real-time updates.
- Snowflake-based ID generation (idgen) for globally unique message and sequence identifiers.
- Seamless integration for AI coding agents through the Openclaw Skills metadata standard.
SKILL.md
Loading
Related Openclaw Skills
Social Alignment
A five-lens ethical decision engine that provides sovereign AI agents with the judgment to evaluate risks and escalate critical actions to humans.
Eden AI
A comprehensive integration that allows AI agents to access dozens of AI providers for text, image, video, and audio analysis through a single unified interface.
Web Artifacts Builder
A professional-grade toolkit for developing, bundling, and sharing complex React-based Claude.ai artifacts with modern styling.
OpenClaw Backup
A comprehensive backup and restoration utility designed to safeguard OpenClaw configurations, credentials, and agent workspaces.
JSONLint
A comprehensive Python-powered CLI toolkit for validating, formatting, and manipulating JSON data with precision.
Miro CLI
A powerful CLI wrapper for the Miro Platform API, enabling seamless board management, team organization, and automated data exports directly from your terminal.
Featured*
