核心概念
理解 OpenClaw 的关键概念,有助于更好地配置和使用你的个人 AI 助手。
架构
OpenClaw 的核心是 Gateway,它是消息路由的唯一入口。
WhatsApp
Telegram
Discord
更多…
↓
⚡ Gateway
↓
AI Agent
Web 控制台
移动节点
记忆系统 (Memory)
OpenClaw 的记忆系统通过本地文件实现跨会话的持久化。
| 文件 | 用途 |
|---|---|
MEMORY.md | 长期记忆,重要决策、偏好、经验的精炼存储 |
memory/YYYY-MM-DD.md | 每日日志,原始对话记录 |
SOUL.md | Agent 人格定义 |
USER.md | 用户信息,姓名、偏好、时区等 |
AGENTS.md | 工作空间行为规则 |
HEARTBEAT.md | 定时心跳任务清单 |
最佳实践: 把重要信息写入文件,Agent 每次会话都是全新的,只有写入文件的内容才能跨会话保留。
会话管理
每个发件人或频道都有独立的隔离会话。Gateway 负责维护所有活跃会话的状态。
# 查看活跃会话 openclaw sessions list # 重置上下文 /new
多 Agent 路由
支持同时运行多个 AI Agent,每个 Agent 有独立的工作空间。
- Pi(内置)— OpenClaw 默认 Agent
- Claude Code — Anthropic 的编码 Agent
- Codex — OpenAI 的编码 Agent
模型提供商
| 提供商 | 推荐模型 |
|---|---|
| Anthropic | Claude 3.7 Sonnet(推荐) |
| OpenAI | GPT-4o、o3 |
| OpenRouter | 聚合多个提供商 |
| Moonshot | moonshot-v1(国内可访问) |
| Qwen(通义) | qwen-max |
| Ollama | 本地运行,无需 API Key |
心跳系统 (Heartbeat)
编辑 HEARTBEAT.md 添加待检查任务,让 Agent 主动工作:
# HEARTBEAT.md
- 每天检查重要邮件
- 提醒即将到来的日历事件(2小时内)
Cron 任务
# 每天早上9点发送日报 openclaw cron add "0 9 * * *" "生成今日待办事项摘要并发送给我"