部分OpenCLAW 师资课程-@叶梓老师《OpenCLAW 一日技术培训》

OpenCLAW 一日技术培训提纲

1.掌握OpenCLAW 三大核心组件的技术原理与协同逻辑

2.独立完成Agent 配置、Skill 开发与调用

3.具备复杂Skill 开发能力（多步骤流水线、状态管理、异常处理）

4.掌握全链路问题排查与性能优化方法，适配企业级私有化部署需求

课程大纲

上午：核心原理与环境搭建

模块1：OpenCLAW 技术定位与架构拆解

·核心定位：从”对话AI”到”执行型AI Agent”的范式跃迁，官方定位为 AI Agent 运行时环境（真正能做事的AI）

·核心架构三要素：

oGateway（统一入口/网关）：请求路由、认证鉴权、负载均衡

oAgent（智能执行核心）：任务拆解、决策调度、上下文管理

oWorkspace（工作环境）：文件系统隔离、环境变量、持久化存储

·与传统AI/RAG的核心差异：

o无状态文本交互→ 有状态Agent Loop（感知→决策→行动→记忆）

o被动响应→ 主动执行（工具调用、文件操作、代码运行）

·技术栈全景：TypeScript 核心、LLM 适配层（OpenAI/Anthropic/本地模型）、MCP 协议层、Skill 插件层、向量存储层

模块2：Agent 核心原理与开发范式

·核心定义：驱动系统思考的核心单元，负责任务拆解、上下文管理、决策调度

·Agent Loop 全流程深度解析：

o输入解析（自然语言→结构化意图）

o上下文组装（系统提示+ 历史会话 + 记忆检索 + 技能描述）

o模型推理（LLM 调用与响应解析）

o工具调用（Skill 匹配与参数提取）

o结果持久化（记忆更新、文件写入、状态同步）

·记忆系统架构：

oMEMORY.md：长期记忆存储格式（Markdown 结构化）

o记忆检索机制：向量相似度搜索+ 时间衰减权重

o记忆写入策略：自动摘要vs 关键信息提取

·会话隔离机制：

o线程级隔离（Thread ID）

o上下文窗口管理（Token 限制与压缩策略）

o/compact指令：智能上下文压缩实现原理

·开发范式详解：

oAGENTS.md：Agent 行为定义规范（目标描述、能力边界、禁止事项）

oSOUL.md：人格边界定义（语气风格、价值观约束、安全红线）

oSystem Prompt 注入规范：层级优先级与覆盖规则

·实操任务：

模块3：MCP 协议精要

·核心定位：Model Context Protocol（模型上下文协议），统一 AI 与外部工具通信标准

·核心机制：

o双向RPC 通信（JSON-RPC 2.0）

o工具发现（ListTools）与调用（CallTool）

o传输层支持：stdio（本地进程）、SSE（远程服务）

·与Skill 的关系：

oMCP 是”通用接口协议”，Skill 是”具体业务实现”

oMCP 承载 Skill 的执行通信，Skill 通过 MCP 暴露能力

·快速接入实操：

午休

下午：实战开发与全链路协同

模块4：Skill 开发规范与实战

·核心定义：Agent 可调用的”工具包”，基于 Markdown 声明式配置

·三级加载体系：

o工作区技能（Workspace）：项目级定制，优先级最高

o本地技能（Local）：用户级共享，跨项目复用

o捆绑技能（Built-in）：系统内置，基础能力保障

o覆盖规则解析：同名技能的加载优先级与合并策略

·SKILL.md 开发规范深度解析：

o必选字段：name、description、version、author

o元数据配置：

§bins：外部二进制依赖声明与自动安装

§env：环境变量要求与默认值

§permissions：文件系统权限、网络访问权限

o输入输出定义：

§JSON Schema 参数校验

§输出格式约定（文本/JSON/文件路径）

§错误码规范与异常信息标准化

·实战任务1：基础 Skill 开发

o开发文件读取Skill（带编码自动检测）

o配置元数据与权限声明

o完成Agent 调用联调与边界测试

·实战任务2：进阶 Skill 开发

o开发API 调用 Skill（RESTful 集成）

o实现请求签名、超时控制、重试机制

o集成MCP 协议实现跨服务通信

·实战任务3：复杂 Skill 开发

o开发”代码分析与重构”Skill

o实现多步骤流水线（解析→分析→生成→验证）

o状态机管理与中间结果缓存

·最佳实践：

o技能隔离：