跳转到内容

核心模块总览

components/claw_modules/ 下的模块是 ESP-Claw 的运行时框架,负责 Agent Loop 运行、能力注册与调用、事件路由与自动化、上下文持久化等核心逻辑。 各 cap_* 能力插件通过框架层提供的统一接口注册与执行,不直接耦合彼此。除了 claw_coreclaw_event_router 外,各模块可不加载。

模块职责
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_skillSkills 目录、skills_list.json 目录渲染、按 session 的激活状态持久化,以及向模型注入「目录 + 已激活 Skill 文档」。