QuotaCheap Playbook

OpenClaw Architecture: Gateway, agents, channels và sessions hoạt động với nhau thế nào

Giải thích kiến trúc OpenClaw production: Gateway, config, agents, channels, routing, sessions, DM isolation, WebChat, cron tasks và QuotaCheap usage visib…

Muốn chạy agent production thì phải hiểu Gateway sở hữu runtime, channels đưa message vào, routing chọn agent, và sessions giữ context.

Bài viết giải thích kiến trúc OpenClaw bằng tiếng Việt: Gateway, config, agents, channels, bindings, session keys, DM/group isolation, WebChat, cron/background tasks, visible replies và cách QuotaCheap bổ sung usage/cost visibility ở lớp model gateway.

Nếu chỉ nhìn từ ngoài, OpenClaw có thể bị hiểu nhầm là “một chatbot có nhiều channel”.

Cách hiểu đó quá mỏng.

Production agent không chỉ cần trả lời tin nhắn; nó cần biết tin nhắn đến từ đâu, ai được phép gọi, agent nào xử lý, context nằm ở session nào, output quay lại đâu, job nền chạy thế nào, và model usage được kiểm soát ra sao.

Kiến trúc OpenClaw xoay quanh một vài khối chính: Gateway : runtime trung tâm, đọc config, kết nối channels, quản lý routing/session/tools/automation.

Agents : workspace + model/tool/policy + session store riêng.

Channels : Telegram, WhatsApp, Discord, Slack, Signal, iMessage, WebChat và plugin channels.

Routing : quyết định inbound message vào agent/session nào và reply quay về đâu.

Sessions : nơi context và transcripts sống.

Automation : cron, background tasks, hooks, webhooks.

Hiểu đúng các khối này giúp bạn debug nhanh hơn.

Không thì mọi lỗi đều nhìn giống “model ngu” — trong khi nhiều khi là route sai, session sai, allowlist sai, hoặc delivery sai.

Đổ lỗi cho model quá sớm thường làm chậm debug.

Gateway là runtime owner OpenClaw Gateway là tiến trình sở hữu runtime.

Docs configuration nói OpenClaw đọc config JSON5 optional từ: Nếu file thiếu, OpenClaw dùng safe defaults.

Khi cần kết nối channels, set models/tools/sandboxing/automation, tune sessions/media/networking/UI, bạn thêm config.

Gateway chịu trách nhiệm: đọc và validate config; kết nối channel plugins; nhận inbound messages; chọn agent theo routing rules; mở/ghi session; expose tools theo policy; deliver visible replies; chạy cron/background automation; giữ state như sessions và run history.

Nói ngắn: model không phải runtime.

Model là một worker được Gateway gọi vào đúng lúc, với context và tools đã được host chuẩn bị.

Config là hợp đồng vận hành, không phải note cá nhân Docs nhấn mạnh OpenClaw chỉ accept config match schema.

Unknown keys, malformed types hoặc invalid values làm Gateway refuse to start.

Khi validation fail, chỉ diagnostic commands như openclaw doctor, openclaw logs, openclaw health, openclaw status còn hữu dụng.

Config có thể edit bằng: Hoặc Control UI tại http://127.0.0.1:18789, hoặc edit trực tiếp openclaw.json.

Production lesson: đừng treat config như scratchpad.

Nó là source of truth cho access, routing, sessions, tools và automation.