OpenClaw 深度学习指南

🏗️ 一、核心运行机制

架构总览

┌─────────────────────────────────────────────────┐
│                   Gateway（网关）                 │
│           单个长驻进程，管理一切                   │
├─────────────┬──────────┬──────────┬─────────────┤
│  WhatsApp   │ Telegram  │ Discord  │  WebChat    │
│  飞书/Signal │ Slack/iM  │ 插件通道  │  浏览器UI   │
├─────────────┴──────────┴──────────┴─────────────┤
│              WebSocket 协议层                     │
├─────────────────────────────────────────────────┤
│  AI Agent（主代理）  ←→  SubAgent（子代理）     │
├─────────────────────────────────────────────────┤
│  会话管理 | 记忆系统 | 工具调用 | 定时任务       │
├─────────────────────────────────────────────────┤
│  Node节点（手机/iOS/Android - 摄像头/定位/语音） │
└─────────────────────────────────────────────────┘

核心组件

组件	说明
Gateway	核心网关进程，管理所有消息通道和AI代理
Agent	AI代理，处理对话、工具调用、记忆
Sessions	会话管理，每个对话独立上下文
Nodes	移动节点，提供摄像头、定位、Canvas等能力
Plugins	插件系统，扩展功能（飞书、语音通话等）
Skills	技能系统，预定义的工具集合

通信协议

• 传输层：WebSocket，JSON 文本帧
• 握手：第一帧必须是 connect
• 请求：{type:"req", id, method, params} → {type:"res", id, ok, payload}
• 事件：{type:"event", event, payload}（服务端推送）
• 认证：Token 或 Password

---

🔧 二、重要功能

1. 多模型配置与故障转移

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "zai/glm-5-turbo",
        "fallbacks": ["zai/glm-5", "zai/glm-4.7"]
      }
    }
  }
}

• 主模型失败时自动切换备用模型
• 支持多个 Provider（智谱、豆包、Claude、百度千帆）

2. 会话管理

• 每个会话独立上下文窗口
• 支持 Compaction（上下文压缩）
• 会话隔离：不同通道/用户/群组独立会话
• 子代理会话独立运行

3. 记忆系统

• MEMORY.md：长期记忆文件
• memory/ 目录：按日期分文件
• HEARTBEAT.md：心跳检查任务
• TASKS.md：长期任务持久化
• 语义搜索：memory_search 工具

4. 定时任务（Cron Jobs）

• 支持 cron 表达式
• 支持一次性/循环任务
• 支持 webhook 回调
• 支持系统事件注入
• 支持隔离会话运行

5. 工具系统

• exec：Shell 命令执行
• browser：浏览器控制
• web_fetch/web_search：网页抓取和搜索
• canvas：可视化画布
• nodes：移动节点控制
• cron：定时任务管理
• message：消息发送
• feishu*：飞书集成

6. 子代理系统

• sessions_spawn 创建独立子代理
• 上下文隔离，互不污染
• 支持运行完成后自动清理
• 支持多种运行时（subagent/acp）

7. 技能系统（Skills）

• SKILL.md 定义技能规则
• 支持技能发现和安装（ClawHub）
• 自动匹配任务到技能
• 支持技能更新

8. 插件系统（Plugins）

• 飞书插件、语音通话等
• 扩展通道和工具
• openclaw plugins list 查看已安装
• openclaw plugins install @openclaw/xxx 安装

9. Node节点

• iOS/Android 设备配对
• 摄像头拍照/录像
• GPS 定位
• 通知推送
• 屏幕录制
• Canvas 画布显示

---

🖥️ 三、后台网页（Control UI）功能

访问地址

http://127.0.0.1:18789/

核心面板

面板	功能	说明
Chat	对话界面	与AI对话，查看工具调用结果
Sessions	会话管理	查看所有会话，调整模型/思考模式/推理参数
Cron Jobs	定时任务	创建/编辑/启停定时任务，查看运行历史
Channels	通道管理	WhatsApp/Telegram/Discord/飞书状态和配置
Skills	技能管理	启用/禁用/安装技能
Nodes	节点管理	查看配对的移动设备
Config	配置编辑	可视化编辑 openclaw.json（支持表单和JSON）
Debug	调试面板	状态快照、健康检查、事件日志、手动RPC调用
Logs	日志查看	实时查看Gateway日志

重要功能详解

1. Chat面板

• 实时流式对话
• 工具调用过程可视化
• 支持中断生成（Stop按钮或 /stop）
• 支持注入系统消息（chat.inject）

2. Sessions面板

• 查看所有活跃会话
• 修改会话模型（per-session override）
• 调整思考模式（thinking）
• 调整推理参数（reasoning）

3. Cron Jobs面板

• 图形化创建定时任务
• 支持 cron 表达式
• 支持选择执行模式（主会话/隔离会话）
• 支持投递方式（announce/webhook/none）
• 支持运行历史查看

4. Config面板

• 表单模式：可视化编辑，支持配置验证
• JSON模式：原始JSON编辑
• Schema浏览：查看配置字段说明
• 修改后自动验证 + 重启
• base-hash 防止并发编辑冲突

5. Debug面板

• Status：当前状态快照
• Health：健康检查
• Models：模型列表和状态
• Event Log：实时事件日志
• Manual RPC：手动发送WebSocket请求

6. 日志面板

• 实时日志流
• 支持过滤
• 支持导出

---

📚 四、深入学习路径

推荐阅读顺序

1. Gateway Architecture - 理解核心架构
2. Agent Runtime - 理解代理运行机制
3. Session Management - 会话管理
4. Memory - 记忆系统
5. Compaction - 上下文压缩
6. Cron Jobs - 定时任务
7. Multi-Agent Routing - 多代理路由
8. Configuration Reference - 完整配置参考
9. Control UI - 网页UI
10. Nodes - 移动节点

常用CLI命令

openclaw status          # 系统状态
openclaw tui             # 终端对话
openclaw sessions list   # 查看会话
openclaw cron list       # 查看定时任务
openclaw plugins list    # 查看插件
openclaw skills list     # 查看技能
openclaw models          # 查看模型
openclaw logs --follow   # 实时日志
openclaw gateway restart # 重启网关
openclaw update          # 自更新

---

这些是OpenClaw的核心内容，建议按照上面的学习路径逐步深入了解！