ARCHITECTURE OVERVIEW

OpenClaw Software Components (Draft)

Local Execution Environment  ·  Windows 11 + Telegram + AI APIs

This diagram illustrates the local execution environment and message flow for an OpenClaw-based AI agent system running on a Windows 11 PC, integrated with Telegram and external AI model APIs.

The user interacts via the Telegram app (desktop or iPhone), sending messages to a configured bot (@Bundle5876Bot). Messages are routed through the Telegram Cloud Bot API and delivered to the OpenClaw application running locally.

OpenClaw is a Node.js-based system with two main processes: a Launcher Process that initializes and monitors the system, and a Gateway Process that handles core runtime operations — polling Telegram, managing request handling, executing tool-based actions, and orchestrating calls to external AI services.

Within the Gateway, the Loki Persona Layer constructs prompts by combining system instructions with user input and injecting a defined personality to shape consistent responses. Processed requests are sent to the Claude API (Anthropic) or Gemini API (Google). API rate limit errors (HTTP 429) are surfaced back to the user via Telegram.

Component Diagram

📱 Pinch to zoom  ·  Scroll to pan
OpenClaw Software Components diagram showing Windows 11 PC, Telegram Desktop and iPhone apps, Telegram Cloud Bot API, OpenClaw NodeJS Gateway and Launcher processes, Loki Persona Layer, Claude API, Gemini API, and log file output

Key Components

TG
Telegram Bot — @Bundle5876Bot receives user messages on desktop and iPhone
☁️
Telegram Cloud — Bot API routes messages to the local OpenClaw app
▶
Launcher Process — Starts and monitors the Gateway (PID 5756)
GW
Gateway Process — Core runtime: polling, request handling, tool execution, LLM calls (PID 30528)
LK
Loki Persona Layer — Constructs prompts and injects consistent personality into responses
CL
Claude API — Anthropic's claude-sonnet-4-6 model for primary AI responses
GM
Gemini API — Google's model used for web search and auxiliary tasks
📋
Log File — Activity logged to \tmp\openclaw\openclaw-2026-03-24.log