核心模块总览
claw_modulescomponents/claw_modules/ 下的模块是 ESP-Claw 的运行时框架，负责 Agent Loop 运行、能力注册与调用、事件路由与自动化、上下文持久化等核心逻辑。
各 cap_* 能力插件通过框架层提供的统一接口注册与执行，不直接耦合彼此。除了 claw_core 与 claw_event_router 外，各模块可不加载。
模块职责速览
Section titled “模块职责速览”| 模块 | 职责 |
|---|---|
| claw_core | 维护请求队列与后台任务，组装 system / messages / tools 上下文，驱动大语言模型多轮与工具调用，并通过回调写回会话历史、调用 claw_cap。 |
| claw_cap | 能力注册表：按 group 管理描述符、生命周期、大语言模型可见分组，统一执行入口，并向 claw_core 提供 tools JSON。 |
| claw_event_router | 统一事件入口：规则匹配、call_cap / run_agent / run_script / send_message 等动作链；run_agent 异步提交至 claw_core，响应通过 out_message 事件发布。事件类型定义见 claw_event.h，发布 API 见 claw_event_publisher.h。 |
| claw_memory | 会话历史与长期记忆文件的读写，并作为 claw_core 的 context provider。 |
| claw_skill | Skills 目录、SKILL.md 元数据渲染、按 session 的激活状态持久化，以及向模型注入 Skills 目录清单。已激活 Skill 文档通过 activate_skill 工具返回值注入会话历史。 |
| claw_ramfs | RAM-backed 文件系统，通过 VFS 接口提供高速内存文件存储，支持与 FATFS 双向同步。 |
各模块详细文档
Section titled “各模块详细文档” claw_core Agent 请求队列、上下文组装、大语言模型循环与工具调用边界
claw_cap 能力注册表、group 生命周期与大语言模型工具可见性
claw_event_router 事件入口、自动化规则匹配、出站通道绑定
claw_memory 会话历史与长期记忆文件的读写
claw_skill Skills 目录与 session 级激活状态管理
claw_ramfs RAM 文件系统 — 高速内存存储与 FATFS 同步