核心概念
理解 OpenClaw 的关键概念，用起来更得心应手。不需要全记住，用到的时候回来查就行。
整体架构
OpenClaw 由三层组成，像一个三明治：
┌───────────────────────────────────────────┐
│ 聊天平台（你发消息的地方） │
│ Telegram │ Discord │ WhatsApp │ iMessage │
└───────────────────┬───────────────────────┘
│ 消息传递
▼
┌───────────────────────────────────────────┐
│ Gateway（消息中枢） │
│ 路由消息 │ 管理会话 │ 调度工具 │ 安全控制 │
└───────────────────┬───────────────────────┘
│ API 调用
▼
┌───────────────────────────────────────────┐
│ AI 模型（大脑） │
│ Claude │ GPT │ 豆包 │ Gemini │ 本地模型 │
└───────────────────────────────────────────┘简单说：你在聊天平台发消息 → Gateway 接收并转给 AI 模型 → AI 思考后回复 → Gateway 把回复发回聊天平台。
Gateway（网关）
Gateway 是 OpenClaw 的核心进程，相当于大管家。它负责：
- 收发消息 — 连接所有聊天平台，统一处理收到的消息
- 调用 AI — 把消息发给 AI 模型，拿到回复
- 管理工具 — AI 需要执行命令、读写文件时，Gateway 提供这些能力
- 安全控制 — 检查谁有权限跟 AI 对话，限制危险操作
# Gateway 常用操作
openclaw gateway start # 启动
openclaw gateway stop # 停止
openclaw gateway restart # 重启
openclaw gateway status # 查看状态Gateway 停了，AI 就"下线"了。安装脚本会配置开机自启，正常情况下你不需要手动管理它。
Agent（代理）
Agent 就是你的 AI 助手。每个 Agent 有自己的：
- 性格 — 通过 SOUL.md 文件定义它是谁、说话风格
- 记忆 — 通过 MEMORY.md 和 memory/ 目录存储长期记忆
- 能力 — 通过 Skills 扩展它能做的事
- 工作区 — 一个独立的文件夹，放它的所有文件
你可以配置多个 Agent（比如一个工作用、一个生活用），通过路由规则决定不同聊天平台用哪个 Agent。
Session（会话）
Session 是一次完整的对话。当你在 Telegram 发第一条消息时，OpenClaw 会创建一个 Session。之后的消息都在这个 Session 中延续上下文。
关键点：
- 每个聊天平台/频道对应一个 Session
- Session 保存了所有对话历史，AI 能记住你之前说的话
- 历史太长时，OpenClaw 会自动压缩（compaction），保留重要内容
- 你可以用
/reset命令清空当前 Session，重新开始
# 查看所有活跃会话
openclaw sessions list
# 查看某个会话详情
openclaw sessions info <session-key>Workspace（工作区）
工作区是 Agent 的"家"，默认在 ~/.openclaw/workspace/。
工作区里的重要文件：
| 文件 | 作用 |
|---|---|
AGENTS.md | Agent 的行为规范和工作流程 |
SOUL.md | Agent 的性格和身份定义 |
USER.md | 关于你（用户）的信息 |
MEMORY.md | Agent 的长期记忆 |
TOOLS.md | 工具配置和本地笔记 |
IDENTITY.md | Agent 的名字、性别等基本信息 |
memory/ | 按日期存放的每日记忆 |
想让 AI 叫你"老板"？编辑 USER.md。想改 AI 的性格？编辑 SOUL.md。这些文件就是 AI 的"大脑设定"。
Memory（记忆系统）
AI 每次"醒来"（新 Session 开始）时记忆是空白的。记忆系统让 AI 能"记住"之前的事情。
记忆分两层：
- 每日记忆（
memory/YYYY-MM-DD.md）— 每天发生了什么，原始记录 - 长期记忆（
MEMORY.md）— 从每日记忆中提炼的精华，重要的事、偏好、教训
AI 每次开始新 Session 时会自动读取这些文件，恢复"记忆"。就像人醒来后回忆昨天发生了什么。
Heartbeat（心跳）
心跳让 AI 可以主动做事，而不仅仅是被动回复。
开启心跳后，OpenClaw 会定期"唤醒" AI（比如每 30 分钟一次），AI 可以：
- 检查是否有新邮件
- 查看日历有没有即将到来的活动
- 检查项目进度
- 主动给你发消息通知重要事项
# 心跳配置（config.yaml）
heartbeat:
enabled: true
intervalMinutes: 30 # 每 30 分钟检查一次每次心跳都是一次 AI 调用，会消耗 token。建议不要设太频繁。30 分钟一次是比较平衡的选择。
Cron（定时任务）
Cron 让你设置精确时间触发的任务，比如"每天早上 10 点播报天气"。
# 查看所有定时任务
openclaw cron list
# 添加定时任务
openclaw cron add
# 删除定时任务
openclaw cron remove <id>你也可以在聊天中直接让 AI 创建定时任务：
"每天早上 10 点告诉我天气和新闻"
AI 会自动帮你创建一个 Cron 任务。
Skill（技能）
Skill 是 AI 的能力扩展包。就像给手机装 App 一样，你可以给 AI 安装新技能。
比如：
- weather — 查天气
- coding-agent — 编程代理，让 AI 可以运行 Codex/Claude Code
- apple-notes — 管理 Apple 备忘录
- dns-manage — 管理 DNS 解析
安装技能非常简单：
openclaw skills install weather
openclaw skills install coding-agent更多关于技能的内容请看 技能系统。