核心模块总览
components/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,响应通过 agent_response 事件发布。事件类型定义见 claw_event.h,发布 API 见 claw_event_publisher.h。 |
| claw_memory | 会话历史与长期记忆文件的读写,并作为 claw_core 的 context provider。 |
| claw_skill | Skills 目录、skills_list.json 目录渲染、按 session 的激活状态持久化,以及向模型注入「目录 + 已激活 Skill 文档」。 |
各模块详细文档
Section titled “各模块详细文档” claw_core Agent 请求队列、上下文组装、大语言模型循环与工具调用边界
claw_cap 能力注册表、group 生命周期与大语言模型工具可见性
claw_event_router 事件入口、自动化规则匹配、出站通道绑定
claw_memory 会话历史与长期记忆文件的读写
claw_skill Skills 目录与 session 级激活状态管理