核心概念总览

本节介绍 OpenClaw 的核心工作机制，帮助你理解系统如何运作。

核心组件

概念	描述
Agent	AI 助手的运行时，处理消息并调用工具
会话	对话历史的存储与隔离机制
记忆	Agent 的长期记忆系统（基于工作区文件）
模型选择	多模型配置、备用切换、认证轮换

消息处理流程

用户发送消息
    ↓
Gateway 接收（通过渠道：WhatsApp/Telegram/Discord...）
    ↓
会话路由（确定用哪个 sessionKey）
    ↓
消息队列（debounce 防抖、合并、控制并发）
    ↓
Agent 运行循环
  1. 注入系统提示（AGENTS.md、SOUL.md、记忆文件等）
  2. 调用 AI 模型（含工具定义）
  3. 执行工具（exec、read、write、browser 等）
  4. 重复直到模型不再调用工具
    ↓
发送回复到原渠道

关键设计原则

Gateway 是权威来源：所有状态（会话、认证、配置）都由 Gateway 管理。UI 客户端（macOS App、WebChat）从 Gateway 查询，不直接读本地文件。

路由是确定性的：消息从哪个渠道来，就回复到哪个渠道。模型不能自由选择回复渠道。

记忆依赖写盘：Agent "记住"的内容，必须明确写入工作区文件（MEMORY.md、memory/YYYY-MM-DD.md），仅存在上下文中的内容在会话重置后消失。

工具是第一公民：OpenClaw 通过原生工具（exec、read、write、browser、canvas 等）扩展 Agent 能力，不依赖旧式 shell 脚本 skill。