---
title: 核心模块总览
description: claw_* 框架层职责划分与文档索引，面向二次开发与代码阅读。
---

import { LinkCard, CardGrid } from '@astrojs/starlight/components';

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

## 模块职责速览

| 模块 | 职责 |
|------|--------|
| [claw_core](./claw-core) | 维护请求队列与后台任务，组装 system / messages / tools 上下文，驱动大语言模型多轮与工具调用，并通过回调写回会话历史、调用 `claw_cap`。 |
| [claw_cap](./claw-cap) | 能力注册表：按 group 管理描述符、生命周期、大语言模型可见分组，统一执行入口，并向 `claw_core` 提供 tools JSON。 |
| [claw_event_router](./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-memory) | 会话历史与长期记忆文件的读写，并作为 `claw_core` 的 context provider。 |
| [claw_skill](./claw-skill) | Skills 目录、`SKILL.md` 元数据渲染、按 session 的激活状态持久化，以及向模型注入「目录 + 已激活 Skill 文档」。 |

## 各模块详细文档

<CardGrid>
  <LinkCard title="claw_core" href="./claw-core" description="Agent 请求队列、上下文组装、大语言模型循环与工具调用边界" />
  <LinkCard title="claw_cap" href="./claw-cap" description="能力注册表、group 生命周期与大语言模型工具可见性" />
  <LinkCard title="claw_event_router" href="./claw-event-router" description="事件入口、自动化规则匹配、出站通道绑定" />
  <LinkCard title="claw_memory" href="./claw-memory" description="会话历史与长期记忆文件的读写" />
  <LinkCard title="claw_skill" href="./claw-skill" description="Skills 目录与 session 级激活状态管理" />
</CardGrid>
