核心概念
核心概念
理解 OpenClaw 的核心架构和概念，有助于更好地使用和配置。
架构概览
OpenClaw 采用 Gateway + Agent 架构：
┌─────────────────────────────────────────────────┐
│ Channels │
│ WhatsApp │ Telegram │ Discord │ iMessage ... │
└───────────────────┬─────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ Gateway │
│ • 消息路由 • 认证授权 • 日志审计 │
│ • 会话管理 • 安全边界 • API 服务 │
└───────────────────┬─────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ Agent │
│ Identity │ Soul │ Tools │ Skills │ Memory │
└───────────────────┬─────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ Provider │
│ Claude │ OpenAI │ Local Models │ ... │
└─────────────────────────────────────────────────┘Gateway（网关）
Gateway 是 OpenClaw 的中央协调器，负责：
- 消息路由: 将各渠道消息路由到对应的 Agent
- 认证授权: 管理用户认证和权限控制
- 会话管理: 维护对话上下文和会话状态
- 安全边界: 实施 Sandbox 和工具权限策略
- API 服务: 提供 HTTP API 供外部系统集成
Gateway 模式
- 本地模式: Gateway 运行在本地机器
- 远程模式: Gateway 运行在服务器，通过远程客户端连接
Agent（智能体）
Agent 是 AI 助手的核心，通过工作区文件定义其能力、记忆和交互方式。
工作区文件
| 文件 | 说明 |
|---|---|
IDENTITY | Agent 身份、角色定位 |
SOUL | 核心行为准则和价值观 |
TOOLS | 可用工具列表和权限 |
USER | 用户偏好和设置 |
BOOTSTRAP | 初始化指令 |
HEARTBEAT | 定期主动行为 |
MEMORY | 记忆存储策略 |
详细说明：Agent 调教
Channels（渠道）
渠道是 OpenClaw 与用户交互的入口。
支持的渠道
- WhatsApp: 全球最流行的消息应用
- Telegram: 安全、快速、功能丰富
- Discord: 社区、游戏场景
- iMessage: Apple 生态系统
- Slack: 企业协作
- Matrix: 去中心化通信
渠道特性
- 消息格式: 文本、图片、文件、语音
- 群组支持: 群聊中的 @ 提及和回复
- 异步交互: 消息队列和重试机制
详见：渠道接入
Tools（工具）
工具是 Agent 执行具体任务的能力。
工具类型
| 类型 | 说明 | 示例 |
|---|---|---|
| 浏览器 | Web 自动化 | 抓取网页、填写表单 |
| 执行 | 系统命令 | 文件操作、脚本执行 |
| Web | HTTP 请求 | API 调用、数据获取 |
| 自动化 | 定时任务 | Cron、Heartbeat |
安全机制
- Sandbox: 隔离执行环境
- 审批流程: 危险操作需要用户确认
- 权限控制: 细粒度的工具访问权限
详见：工具
Sandbox（沙箱）
Sandbox 是工具执行的安全隔离环境。
Sandbox 类型
- None: 无隔离（仅用于可信环境）
- Process: 进程级隔离
- Docker: 容器级隔离（推荐）
安全策略
- 文件系统访问限制
- 网络访问白名单
- 命令执行白名单
详见：Gateway 安全
Memory（记忆）
Memory 是 Agent 的记忆存储系统。
记忆类型
| 类型 | 说明 | 持久化 |
|---|---|---|
| 会话记忆 | 对话上下文 | 是 |
| 语义记忆 | 知识和概念 | 是 |
| 程序记忆 | 技能和模式 | 是 |
| 工作记忆 | 当前任务焦点 | 否 |
压缩策略
- Compaction: 会话压缩，保留关键信息
- Summarization: 摘要生成，减少 Token 使用
详见：Agent 记忆
Session（会话）
Session 是用户与 Agent 的一次完整对话。
会话生命周期
- 创建: 首次消息触发
- 活跃: 持续对话
- 休眠: 超时无活动
- 压缩: 长度超限时压缩
- 清理: 超时清理
会话管理
- Session ID: 唯一标识符
- Context: 对话历史和上下文
- Metadata: 会话元数据（时间、渠道等）
Streaming（流式响应）
OpenClaw 支持流式响应，实时返回 AI 生成内容。
流式类型
- Delta: 逐字符返回
- Token: 逐 Token 返回
- Chunk: 按块返回
渠道支持
不同渠道对流式响应的支持程度不同，详见各渠道文档。
术语表
| 术语 | 说明 |
|---|---|
| Gateway | 网关，OpenClaw 的中央协调器 |
| Agent | 智能体，AI 助手的核心 |
| Channel | 渠道，用户交互入口 |
| Tool | 工具，Agent 的执行能力 |
| Provider | 提供商，AI 模型提供商 |
| Sandbox | 沙箱，安全隔离环境 |
| Workspace | 工作区，Agent 配置目录 |
| Session | 会话，一次完整对话 |