乐于分享
好东西不私藏

OpenClaw 从中级到高级完整教程

OpenClaw 从中级到高级完整教程

目录

  • 教程说明:适合谁学习
  • 学习路线:从基础到进阶
  • 核心配置:AGENTS.md 工作规范
  • 记忆优化:构建可靠的记忆体系
  • 子 Agent 应用:团队协作模式
  • 定时任务:Cron 自动化实践
  • Skill 开发:扩展 AI 能力
  • 多渠道部署:全平台接入方案
  • 性能调优:配置参数详解
  • 实战练习清单
  • 疑难解答
  • 进阶学习资源

教程说明:适合谁学习

学习前提

本教程面向已经完成 OpenClaw 基础配置的用户。开始前请确认:

  • ✅ 成功安装 OpenClaw 并能正常运行
  • ✅ 创建基础配置文件(SOUL.md / USER.md / IDENTITY.md)
  • ✅ 了解记忆系统概念(MEMORY.md 与 memorySearch)
  • ✅ 熟悉 workspace 目录结构
  • ✅ 具备基本命令行操作能力

若尚未完成基础配置,建议先阅读原基础教程。


技术要求

  • OpenClaw 正常运行
  • 至少一个 AI 模型 API(Claude 或 GPT)
  • 理解 JSON 与 Markdown
  • 基本文件系统操作能力

学完你将获得

完成本教程后,你将掌握:

  • 完整的工作规范体系
  • 高质量记忆管理结构
  • 子 Agent 并行机制
  • 定时任务自动化
  • 自定义 Skill 开发
  • 多渠道部署能力
  • 性能与成本优化能力

学习路线:从基础到进阶

第一阶段:工作规范建立(30–60 分钟)

  • 创建 AGENTS.md
  • 定义 Session 启动流程
  • 设置记忆写入规则
  • 配置安全边界

第二阶段:记忆系统优化(60–120 分钟)

  • 启用 memoryFlush
  • 优化日志格式
  • 配置自动维护
  • 调整 embedding 模型

第三阶段:高级功能应用(120–240 分钟)

  • 部署子 Agent
  • 创建 Cron 定时任务
  • 开发自定义 Skill
  • 配置多渠道接入

第四阶段:性能调优(1–2 天)

  • 调整模型参数
  • 优化 token 使用
  • 配置缓存策略
  • 监控系统性能

核心配置:AGENTS.md 工作规范

为什么需要 AGENTS.md

  • SOUL.md → 定义性格
  • USER.md → 用户信息
  • IDENTITY.md → 身份标识
  • AGENTS.md → 工作流程手册

AGENTS.md 负责定义:

  • 启动流程
  • 记忆规则
  • 操作边界
  • 行为准则

Session 启动流程示例

保存路径:workspace/AGENTS.md

## Session 启动流程每次会话开始时按顺序执行:1. 读取 SOUL.md2. 读取 USER.md3. 读取 memory/YYYY-MM-DD.md(今天和昨天)4. 主会话额外读取 MEMORY.md自动执行,无需询问。

记忆层级结构

层级
文件
用途
索引层
MEMORY.md
核心索引(<40行)
项目层
memory/projects.md
项目状态
基础设施
memory/infra.md
配置速查
教训层
memory/lessons.md
经验总结
日志层
memory/YYYY-MM-DD.md
每日记录

日志标准格式

【项目:名称】 事件标题结果:一句话概括相关文件:文件路径经验教训:要点检索标签:#tag1 #tag2

原则:

  • 记录结论而非过程
  • 使用标签
  • 单条日志只记录一件事

记忆优化:构建可靠的记忆体系

启用 memoryFlush

编辑 openclaw.json

{  "agents": {    "defaults": {      "compaction": {        "reserveTokensFloor": 20000,        "memoryFlush": {          "enabled": true,          "softThresholdTokens": 4000        }      }    }  }}

作用:

  • 上下文接近限制前
  • 自动写入重要信息
  • 再执行压缩
  • 防止“失忆”

优化 embedding 模型

推荐配置:

{  "memorySearch": {    "enabled": true,    "provider": "openai",    "model": "BAAI/bge-m3"  }}

优势:

  • 成本低
  • 支持中英文
  • 检索精度高

子 Agent:团队协作模式

启用子 Agent

{  "agents": {    "defaults": {      "subAgents": {        "enabled": true,        "maxConcurrent": 3,        "timeout": 300000      }    }  }}

建议:

  • 并发数 3–5
  • 适用于信息收集、数据分析
  • 不适合连续创作任务

定时任务:Cron 自动化

创建任务示例

{  "name": "morning-briefing",  "schedule": "0 8 * * *",  "timezone": "Asia/Shanghai",  "task": {    "type": "message",    "content": "发送今日简报"  },  "enabled": true}

管理命令:

openclaw cron listopenclaw cron run 任务名openclaw cron enable 任务名

Skill 开发:扩展能力

标准结构:

workspace/skills/my-skill/├── SKILL.md├── config.json

建议:

  • 文档清晰
  • 可配置参数独立
  • 加入异常处理
  • 明确版本号

多渠道部署

支持:

  • Telegram
  • Discord
  • WebChat
  • CLI

示例配置:

{  "gateways": {    "telegram": { "enabled": true },    "discord": { "enabled": true }  }}

最佳实践:

  • 权限隔离
  • 消息分类
  • 控制成本

性能调优

推荐模型配置

{  "model": {    "provider": "anthropic",    "name": "claude-3-5-sonnet",    "temperature": 0.7,    "maxTokens": 4096  }}

成本控制

{  "billing": {    "limits": {      "daily": 10.00,      "monthly": 200.00    }  }}

实战练习清单

必做:

  • 创建 AGENTS.md
  • 优化记忆系统
  • 配置子 Agent
  • 创建 2 个 Cron
  • 开发 1 个 Skill
  • 配置 2 个平台
  • 优化性能

疑难解答

常见问题包括:

  • memoryFlush 不触发
  • 子 Agent 超时
  • Cron 未执行
  • memorySearch 无结果
  • 成本过高

建议:

  • 检查配置
  • 重启 OpenClaw
  • 查看日志文件

总结

完成本教程后,你已经掌握:

  • ✅ 工作规范体系
  • ✅ 可靠记忆管理
  • ✅ 并行任务能力
  • ✅ 定时自动化
  • ✅ Skill 扩展机制
  • ✅ 多平台接入
  • ✅ 成本与性能优化

下一步建议:

  • 选择一个真实项目落地
  • 持续优化配置
  • 参与社区交流
  • 开发自己的工作流

版本:2.0
适用于:OpenClaw v2.23 及以上版本
最后更新:2026 年 2 月

#OpenClaw实用指南

免责声明:含第三方意见,不构成财务建议