核心概念
要用好 OpenClaw，先得明白它是怎么工作的。本章把最核心的几个概念讲清楚——不是给你背定义，而是让你真正理解每条消息在系统里经历了什么。
一条消息的完整旅程
你在 Telegram 发一条「帮我写今天的周报」，到最后收到回复，中间发生了这些事：
Telegram → [频道适配器] → Gateway → [路由规则] → Agent
→ [记忆召回] → [工具调用] → AI 模型 → [流式输出] → Telegram每一步都对应一个核心概念：
| 步骤 | 概念 | 你需要关心什么 |
|---|---|---|
| 消息进入 | Channel（频道） | 配置哪个平台、账号认证 |
| 谁来处理 | Agent（智能体） | 系统提示词、工具权限 |
| 记住什么 | Session + Memory | 上下文长度、长期记忆 |
| 怎么想 | Agent Loop | 工具调用次数、超时控制 |
| 怎么回 | Gateway 输出 | 流式 vs 批量、消息分块 |
核心概念速览
Gateway（网关）
Gateway 是整个系统的心脏，一个常驻后台的服务进程。它负责：
- 接收：监听所有已连接频道的消息推送
- 路由：根据规则判断交给哪个 Agent 处理
- 调度：管理定时任务（Cron）和外部触发（Webhook）
- 状态：维护所有会话的上下文状态
一台机器运行一个 Gateway，连接多个频道、托管多个 Agent。
Agent（智能体）
Agent 是「有工具的 AI」。与直接调用 API 的区别在于：
- 有人格（SOUL.md 定义的系统提示词）
- 有工具（网页搜索、代码执行、文件操作等）
- 有记忆（短期会话 + 长期知识库）
同一个 Gateway 可以运行多个 Agent，每个 Agent 可以绑定不同频道。
Session（会话）
每个用户 × 每个 Agent 对应一个独立的 Session。Session 维护：
- 当前对话的消息历史（受 Context Window 限制）
- 用户的临时变量（如正在处理的任务状态）
- 会话级别的工具权限
Session 默认在内存中，重启 Gateway 后清空。需要持久化请配置数据库后端。
Memory（记忆）
OpenClaw 的三层记忆架构：
短期记忆（In-context）：当前 Session 的消息历史
↓ 超出 Context Window 时
中期记忆（Summary）：自动总结压缩后存储
↓ 明确记录的重要信息
长期记忆（Persistent）：跨 Session 持久化的用户数据你不需要手动管理这三层，OpenClaw 自动处理压缩和召回。
Agent Loop（智能体循环）
Agent 收到消息后，进入一个「思考 → 行动 → 观察」的循环：
收到消息
→ 思考：需要调用哪些工具？
→ 行动：调用工具（搜索/执行代码/读文件）
→ 观察：工具返回了什么？
→ 思考：结果够用了吗？继续还是回复？
→ 最终回复默认最多循环 10 次，防止无限循环消耗 token。
章节导航
深入了解每个概念：
- 网关架构 — Gateway 的系统架构图与数据流全览
- Agent 循环 — 工具调用机制、循环控制、错误恢复
- 多 Agent 协作 — Agent 间通信与任务委派
- 会话管理 — Context Window、会话隔离、持久化配置
- 记忆系统 — 三层记忆、RAG 检索、记忆注入时机
- 系统提示词 — SOUL.md 写法、人格设计、指令优先级
- 流式输出与分块 — 流式响应、长消息自动分段、平台差异
- OAuth 认证 — 第三方平台授权、Token 刷新、多账号管理
常见疑问
Q：一个 Gateway 能支持多少并发用户？
取决于 AI 模型的响应速度和你的机器配置。实测在 MacBook M2 上，使用 Claude Haiku 可以轻松支撑 50+ 并发对话。
Q：重启 Gateway 会丢失对话历史吗？
默认会丢失当前 Session 的短期记忆。长期记忆（Memory）和显式保存的数据不受影响。配置持久化数据库后可保留 Session 历史。
Q：Agent 之间能互相通信吗？
可以。通过 多 Agent 协作 功能，一个 Agent 可以将子任务委派给另一个专精的 Agent。