## OpenClaw 深度学习指南

OpenClaw 深度学习指南️ 一、核心运行机制架构总览┌─────────────────────────────────────────────────┐ │ Gateway网关 │ │ 单个长驻进程管理一切 │ ├─────────────┬──────────┬──────────┬─────────────┤ │ WhatsApp │ Telegram │ Discord │ WebChat │ │ 飞书/Signal │ Slack/iM │ 插件通道 │ 浏览器UI │ ├─────────────┴──────────┴──────────┴─────────────┤ │ WebSocket 协议层 │ ├─────────────────────────────────────────────────┤ │ AI Agent主代理 ←→ SubAgent子代理 │ ├─────────────────────────────────────────────────┤ │ 会话管理 | 记忆系统 | 工具调用 | 定时任务 │ ├─────────────────────────────────────────────────┤ │ Node节点手机/iOS/Android - 摄像头/定位/语音 │ └─────────────────────────────────────────────────┘核心组件组件说明Gateway核心网关进程管理所有消息通道和AI代理AgentAI代理处理对话、工具调用、记忆Sessions会话管理每个对话独立上下文Nodes移动节点提供摄像头、定位、Canvas等能力Plugins插件系统扩展功能飞书、语音通话等Skills技能系统预定义的工具集合通信协议传输层WebSocketJSON 文本帧握手第一帧必须是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.工具系统execShell 命令执行browser浏览器控制web_fetch/web_search网页抓取和搜索canvas可视化画布nodes移动节点控制cron定时任务管理message消息发送feishu*飞书集成6.子代理系统sessions_spawn创建独立子代理上下文隔离互不污染支持运行完成后自动清理支持多种运行时subagent/acp7.技能系统SkillsSKILL.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支持表单和JSONDebug调试面板状态快照、健康检查、事件日志、手动RPC调用Logs日志查看实时查看Gateway日志重要功能详解1. Chat面板实时流式对话工具调用过程可视化支持中断生成Stop按钮或 /stop支持注入系统消息chat.inject2. Sessions面板查看所有活跃会话修改会话模型per-session override调整思考模式thinking调整推理参数reasoning3. Cron Jobs面板图形化创建定时任务支持 cron 表达式支持选择执行模式主会话/隔离会话支持投递方式announce/webhook/none支持运行历史查看4. Config面板表单模式可视化编辑支持配置验证JSON模式原始JSON编辑Schema浏览查看配置字段说明修改后自动验证 重启base-hash 防止并发编辑冲突5. Debug面板Status当前状态快照Health健康检查Models模型列表和状态Event Log实时事件日志Manual RPC手动发送WebSocket请求6. 日志面板实时日志流支持过滤支持导出 四、深入学习路径推荐阅读顺序Gateway Architecture - 理解核心架构Agent Runtime - 理解代理运行机制Session Management - 会话管理Memory - 记忆系统Compaction - 上下文压缩Cron Jobs - 定时任务Multi-Agent Routing - 多代理路由Configuration Reference - 完整配置参考Control UI - 网页UINodes - 移动节点常用CLI命令openclaw status# 系统状态openclaw tui# 终端对话openclaw sessions list# 查看会话openclawcronlist# 查看定时任务openclaw plugins list# 查看插件openclaw skills list# 查看技能openclaw models# 查看模型openclaw logs--follow# 实时日志openclaw gateway restart# 重启网关openclaw update# 自更新这些是OpenClaw的核心内容建议按照上面的学习路径逐步深入了解