OpenClaw 第一阶段详细学习指南

基础认知1-2天目标理解 OpenClaw 是什么核心概念第一部分OpenClaw 核心概念1. 什么是 OpenClawOpenClaw 是一个开源 AI 助手框架它让你能够 创建智能 AI 助手 集成多种外部服务和工具 实现 AI 的长期记忆和连续性 构建复杂的自动化工作流 支持多渠道通信Discord、Telegram、WeChat 等核心理念让 AI 不仅能回答问题还能记住你、理解你的需求、主动帮助你。2. OpenClaw 的主要特性2.1 Skills技能什么是 Skill一个独立的、可复用的功能模块类似于插件或扩展可以是工具、服务、或工作流Skill 的结构my-skill/ ├── SKILL.md # 技能说明文档 ├── scripts/ # 脚本文件 │ ├── main.py │ └── helper.js ├── references/ # 参考资料 │ └── README.md └── config.json # 配置文件可选Skill 的例子pdf- PDF 文件处理读取、合并、转换xlsx- Excel 表格处理frontend-design- 前端界面设计email-skill- 邮件收发weather-advisor- 天气查询为什么需要 Skills模块化每个 Skill 独立开发和维护可复用一个 Skill 可以被多个 Agent 使用易分享可以发布到 ClawHub 供他人使用易扩展新增功能只需添加新 Skill2.2 Sessions会话什么是 Session一个独立的对话上下文每个 Session 有自己的状态、记忆、配置Session 的类型类型说明用途Main Session主会话与用户直接交互日常对话、主要工作流Isolated Session隔离会话独立运行后台任务、并行处理Sub-agents子代理由主代理创建分工合作、任务分解Thread-bound线程绑定会话Discord 线程、群组讨论Session 的生命周期创建 → 初始化 → 运行 → 保存状态 → 销毁实际例子主会话你与 AI 对话 ├─ 子会话 1后台处理数据 ├─ 子会话 2生成报告 └─ 子会话 3发送通知2.3 Agents代理什么是 Agent一个 AI 实体能够理解用户意图调用 Skills 完成任务做出决策学习和记忆Agent 的能力推理- 分析问题、制定计划工具使用- 调用 Skills 和外部 API思考- 深度思考模式Reasoning记忆- 长期和短期记忆目标导向- 为了完成任务而行动Agent 的配置name: 我的助手 model: claude-3.5-sonnet # 使用的 AI 模型 reasoning: enabled # 启用深度思考 memory: enabled # 启用记忆系统 skills: - pdf - xlsx - email-skill2.4 Memory记忆为什么需要记忆没有记忆的 AI 每次都是新的无法学习记忆让 AI 能够记住用户的偏好理解对话的上下文做出更好的决策Memory 的类型类型说明例子MEMORY.md长期记忆用户名、偏好、重要决定memory/YYYY-MM-DD.md日记每日活动、学习笔记Session 状态会话记忆当前对话的上下文记忆的工作流程用户输入 → 搜索相关记忆 → 结合记忆回答 → 更新记忆实际例子# MEMORY.md ​ ## 用户信息 - 名字张三 - 时区Asia/Shanghai - 职业产品经理 ​ ## 偏好 - 喜欢简洁的回答 - 不喜欢过多的表情符号 - 工作时间9:00-18:00 ​ ## 重要项目 - 项目 A进行中截止日期 2026-04-15 - 项目 B已完成第二部分架构概览1. OpenClaw 系统架构┌─────────────────────────────────────────────────────┐ │ 用户界面层 │ │ (Web Chat / Discord / Telegram / WeChat / etc) │ └────────────────────┬────────────────────────────────┘ │ ┌────────────────────▼────────────────────────────────┐ │ Gateway网关 │ │ - 消息路由 │ │ - 会话管理 │ │ - 认证授权 │ └────────────────────┬────────────────────────────────┘ │ ┌────────────────────▼────────────────────────────────┐ │ Agent 核心 │ │ - 消息处理 │ │ - 决策引擎 │ │ - Skill 调用 │ └────────────────────┬────────────────────────────────┘ │ ┌────────────┼────────────┐ │ │ │ ┌────▼───┐ ┌─────▼──┐ ┌─────▼──┐ │ Skills │ │ Memory │ │ Cron │ └────────┘ └────────┘ └────────┘2. Gateway网关Gateway 是什么OpenClaw 的中枢神经系统负责接收来自各渠道的消息路由消息到正确的 Agent管理会话生命周期处理认证和授权Gateway 的职责消息输入 → 解析 → 路由 → Agent 处理 → 消息输出Gateway 的配置位置~/.openclaw/config.yaml常见 Gateway 命令openclaw gateway status # 查看网关状态 openclaw gateway start # 启动网关 openclaw gateway stop # 停止网关 openclaw gateway restart # 重启网关3. CLI 工具Command Line Interface什么是 CLI命令行工具用于管理 OpenClaw让你能够通过终端控制 OpenClaw主要命令分类3.1 系统管理openclaw status # 查看系统状态 openclaw help # 查看帮助 openclaw version # 查看版本3.2 Gateway 管理openclaw gateway status # 网关状态 openclaw gateway start # 启动 openclaw gateway stop # 停止 openclaw gateway restart # 重启3.3 Skills 管理openclaw skills list # 列出所有 Skills openclaw skills check # 检查环境 openclaw skills install pdf # 安装 Skill openclaw skills remove pdf # 移除 Skill3.4 配置管理openclaw config get # 查看配置 openclaw config apply # 应用配置 openclaw config patch # 部分更新4. Skills 系统Skills 系统的工作流程1. 用户请求 ↓ 2. Agent 分析请求 ↓ 3. 确定需要哪个 Skill ↓ 4. 调用 Skill ↓ 5. Skill 执行任务 ↓ 6. 返回结果 ↓ 7. Agent 整理结果 ↓ 8. 返回给用户Skill 的生命周期开发 → 测试 → 发布 → 安装 → 使用 → 更新 → 卸载内置 Skills 示例Skill功能用途pdfPDF 处理读取、合并、转换 PDFxlsxExcel 处理读写、分析表格docxWord 处理创建、编辑文档frontend-design前端设计创建网页界面email-skill邮件管理收发邮件weather-advisor天气查询获取天气信息news-summary新闻摘要获取最新新闻5. Session 管理Session 的管理方式# 查看会话 sessions_list # 列出所有会话 ​ # 创建会话 sessions_spawn # 创建新会话 ​ # 会话通信 sessions_send # 发送消息到其他会话 ​ # 子代理管理 subagents list # 列出子代理 subagents kill # 停止子代理Session 的状态创建 → 活跃 → 空闲 → 销毁第三部分核心概念关系图概念之间的关系┌─────────────────────────────────────────────┐ │ OpenClaw 框架 │ ├─────────────────────────────────────────────┤ │ │ │ Agent代理 │ │ ├─ 使用 Skills 完成任务 │ │ ├─ 管理 Sessions 处理并发 │ │ └─ 维护 Memory 记住信息 │ │ │ │ Skills技能 │ │ ├─ 由 Agent 调用 │ │ ├─ 可以是工具、服务、工作流 │ │ └─ 可以被多个 Agent 共享 │ │ │ │ Sessions会话 │ │ ├─ 由 Agent 创建和管理 │ │ ├─ 可以是主会话或子会话 │ │ └─ 有独立的状态和记忆 │ │ │ │ Memory记忆 │ │ ├─ 由 Agent 维护 │ │ ├─ 跨 Sessions 共享 │ │ └─ 支持搜索和检索 │ │ │ └─────────────────────────────────────────────┘第四部分实际应用场景场景 1个人助手用户: 帮我总结今天的邮件 ↓ Agent 分析请求 ↓ 调用 email-skill 获取邮件 ↓ 调用 AI 模型总结内容 ↓ 返回总结结果 ↓ 更新 Memory记录已总结场景 2内容创作用户: 生成一篇关于 AI 的文章 ↓ Agent 创建子会话处理 ↓ 子会话 1: 搜索相关信息 子会话 2: 生成文章 子会话 3: 检查质量 ↓ 汇总结果 ↓ 返回给用户场景 3自动化工作流定时任务Cron触发 ↓ Agent 启动 ↓ 调用多个 Skills ↓ 处理数据 ↓ 生成报告 ↓ 发送通知第五部分常见问题Q1: OpenClaw 和其他 AI 框架有什么区别A:LangChain- 专注于 LLM 链式调用AutoGPT- 专注于自主代理OpenClaw- 专注于完整的 AI 助手系统包括记忆、多渠道、Skills 等Q2: 我需要编程基础吗A:基础使用不需要创建 Skills需要一些编程知识Python/JavaScript深度定制需要较强的编程能力Q3: OpenClaw 支持哪些 AI 模型A:ClaudeAnthropicGPTOpenAI其他支持 API 的模型可以配置默认模型Q4: 如何保证数据安全A:本地运行数据不上传支持加密存储可以配置访问权限支持离线模式Q5: 可以离线使用吗A:基本功能可以离线使用需要 AI 模型的功能需要网络可以配置本地模型总结第一阶段的核心是理解概念概念作用类比Skills功能模块手机应用Sessions对话上下文聊天窗口AgentsAI 实体虚拟助手Memory信息存储大脑记忆Gateway消息中枢电话交换机官方资源 GitHubhttps://github.com/openclaw/openclaw 官方文档https://docs.openclaw.ai Discord 社区https://discord.com/invite/clawd掌握这些概念后你就能理解 OpenClaw 的工作原理为后续的深入学习打下基础。