# Capricorn-V：面向垂直领域的轻量级智能体运行时

> Capricorn-V 是基于 Capricorn 的垂直领域扩展版本，提供原生 Function Calling 循环、三层记忆系统、Cron 定时任务、Gateway HTTP API 和 MCP 协议支持，通过 vertical_hub 架构实现 tools、skills、workflows 的一键加载，为构建垂直领域智能体应用提供了轻量级但完整的技术栈。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-19T11:15:37.000Z
- 最近活动: 2026-05-19T11:22:46.104Z
- 热度: 161.9
- 关键词: 智能体, Agent Runtime, Function Calling, 垂直领域, MCP, 定时任务, 记忆系统, 工作流, MiniMax
- 页面链接: https://www.zingnex.cn/forum/thread/capricorn-v
- Canonical: https://www.zingnex.cn/forum/thread/capricorn-v
- Markdown 来源: ingested_event

---

## 背景：垂直领域智能体的需求与挑战

大语言模型（LLM）应用的演进正从通用对话向垂直领域深度渗透。然而，构建一个面向特定领域的智能体应用并非易事：需要协调工具调用、管理记忆状态、处理定时任务、暴露服务接口，还要确保系统的可扩展性和可维护性。许多开发者被迫在「使用重量级框架」和「从零自建」之间艰难选择。

Capricorn-V 正是为解决这一困境而设计的轻量级 Agent Runtime。它在保持简洁的同时，提供了构建生产级垂直领域智能体所需的核心能力，通过「配置即用」的设计理念，让开发者能够快速启动并持续扩展。

## 核心设计理念

Capricorn-V 的设计遵循几个关键原则：

### 原生 Function Calling 循环
摒弃复杂的 ReAct 模式或状态机，采用最直接的 LLM → tool_calls → execute → repeat 循环。这种设计减少了抽象层级，使系统行为更可预测，调试更直观。

### 垂直能力一键加载
通过 `vertical_hub` 架构组织 tools、MCP、skills、workflows，只需在 `config.json` 中声明即可使用。这种模块化设计让领域能力的扩展变得像安装插件一样简单。

### 三层记忆系统
结合 JSONL 会话记忆（短期）、MEMORY.md 长期记忆（中期）和 HISTORY.md 历史摘要（长期），为智能体提供完整的上下文管理能力。

### 多模式部署
支持 CLI 交互模式、Gateway HTTP API 模式（带 Cron 和 SSE）、以及完整 Web UI 模式，适应从开发调试到生产部署的不同场景。

## 系统架构详解

Capricorn-V 的代码库结构清晰反映了其架构设计：

```
Capricorn-V/
├── run.py                    # 启动入口（3种模式）
├── config/settings.py         # Pydantic 配置模型
├── agent/
│   ├── executor.py          # CapricornAgent 工厂类
│   ├── agent.py             # CapricornGraph（FC 循环）
│   ├── scheduler.py         # CronScheduler
│   ├── gateway.py           # HTTP API 服务
│   └── notification.py      # 通知总线
├── capabilities/
│   ├── capability_registry.py # 能力注册中心
│   ├── vertical_loader.py    # 垂类加载器
│   └── skills/manager.py     # 技能管理器
├── core/
│   ├── base_tool.py         # BaseTool 抽象基类
│   └── base_workflow.py     # BaseWorkflow 抽象基类
├── memory/
│   ├── session.py           # SessionManager（JSONL 会话）
│   ├── long_term.py         # LongTermMemory（MEMORY.md）
│   └── history.py           # HistoryLog（HISTORY.md）
├── vertical_hub/            # 垂类能力中心
│   ├── manifest.yaml        # 全局注册表
│   └── default/             # 默认垂类（通用能力）
│       ├── vertical.yaml
│       ├── tools/           # BaseTool 子类
│       ├── mcp/config.json  # MCP 配置
│       ├── skills/          # SKILL.md 技能包
│       ├── workflows/       # BaseWorkflow 子类
│       └── prompts/         # system.md / cron.md / bia.md
└── workspace/               # 运行时工作区
```

## 核心工具集

Capricorn-V 提供了一套完整的内置工具，覆盖文件操作、命令执行、任务规划和记忆管理：

### 文件操作工具（file_tools）
- `read_file`：读取文件内容
- `write_file`：写入文件
- `edit_file`：编辑文件（支持 diff 格式）
- `list_files`：列出目录文件

### 执行工具（exec_tools）
- `exec`：执行 shell 命令

### 任务规划工具（todo_tools）
- `todo`：任务规划与追踪

### 定时任务工具（cron_tools）
- `cron`：定时任务管理（create/list/pause/resume/remove）

### 技能与记忆工具
- `skill_view`：按需加载技能说明
- `memory_update`：更新长期记忆
- `history_search`：搜索历史摘要
- `bia_update`：行为修正

## 垂直领域扩展机制

Capricorn-V 的垂直扩展能力是其核心亮点。开发者可以通过以下方式添加自定义能力：

### 添加自定义工具
在垂类的 `tools/` 目录下新建 Python 文件，继承 `BaseTool`：

```python
from typing import Any, Dict
from core.base_tool import BaseTool

class MyTool(BaseTool):
    @property
    def name(self) -> str:
        return "my_tool"
    
    @property
    def description(self) -> str:
        return "工具描述"
    
    @property
    def parameters(self) -> Dict[str, Any]:
        return {"type": "object", "properties": {...}, "required": [...]}
    
    async def execute(self, **kwargs: Any) -> Any:
        return result
```

### 配置 MCP 服务
在 `mcp/config.json` 中配置外部 MCP 服务：

```json
{
  "server-name": {
    "type": "stdio",
    "command": "uvx",
    "args": ["mcp-server-package"],
    "env": {"KEY": "${ENV_VAR}"},
    "enabled": true,
    "enabled_tools": ["*"]
  }
}
```

Capricorn-V 支持 stdio、SSE 和 streamable_http 三种 MCP 接入方式，可灵活集成外部服务。

## Gateway HTTP API

Capricorn-V 提供基于 aiohttp 的轻量级 HTTP 服务，主要端点包括：

| 端点 | 方法 | 说明 |
|------|------|------|
| `/chat` | POST | 对话（支持 thread_id 多会话） |
| `/task` | POST | 异步任务 |
| `/task/{id}` | GET | 查询任务状态 |
| `/jobs` | GET | 列出 Cron 任务 |
| `/events` | GET | SSE 实时推送 |
| `/notifications` | GET | 查询通知 |
| `/notifications/read` | POST | 标记已读 |
| `/health` | GET | 健康检查 |

这种设计使 Capricorn-V 能够轻松集成到现有的 Web 应用架构中，无论是作为独立服务还是嵌入 FastAPI/Flask 应用。

## 定时任务与自进化

Capricorn-V 内置了 Cron 定时任务调度器，通过 FC（Function Calling）管理定时任务，支持 SSE 实时推送任务状态。这为构建需要周期性执行的智能体应用提供了基础能力。

此外，项目还包含 `self-evolution` 技能，可根据执行结果自动优化工作流，以及 `memory_consolidation` 工作流用于自动整合超长对话记忆，体现了向自主优化智能体的探索。

## 部署模式与集成方式

Capricorn-V 支持多种部署和集成方式：

### 1. CLI 交互模式
```bash
python run.py
```

### 2. Gateway API 模式
```bash
python run.py --mode gateway
```

### 3. 完整模式（含 Web UI）
```bash
python run.py --mode gateway_with_webui
```

### 4. 外部项目集成
- **HTTP Gateway**：适用于任何语言的前后端项目（推荐）
- **Python 模块导入**：Python 项目直接使用
- **Docker 部署**：容器化生产环境
- **嵌入 Web 应用**：作为 FastAPI/Flask 子模块

## 配置与环境变量

Capricorn-V 支持通过环境变量注入配置，使用 `${VAR_NAME}` 格式：

```json
{
  "llm": {
    "provider": "openai",
    "model": "MiniMax-M2",
    "api_key": "${OPENAI_API_KEY}",
    "api_base": "https://api.minimax.chat"
  }
}
```

日志系统位于 `logs/` 目录，包括 `trace.log`（全量日志）、`cron.log`（Cron 相关）和 `gateway.log`（HTTP 请求相关），便于问题排查和运行监控。

## 总结与适用场景

Capricorn-V 为垂直领域智能体开发提供了一个轻量级但完整的技术栈。它特别适合以下场景：

- 需要快速构建垂直领域智能体原型的开发者
- 希望保持代码简洁同时不牺牲功能完整性的团队
- 需要在 Apple Silicon 等本地环境运行智能体应用的用户
- 追求模块化、可扩展架构的长期项目

通过原生 FC 循环、极简架构和垂直能力一键扩展的设计理念，Capricorn-V 在复杂性和便利性之间找到了一个平衡点，为智能体应用的开发提供了一个值得考虑的选择。