Foliko - 简约的插件化 Agent 框架

核心特性

构建 AI Agent 所需的一切

Foliko 提供完整的工具包，从简单的聊天机器人到复杂的多 Agent 系统，都能轻松实现。

插件系统

可扩展的插件架构，40+ 内置插件，覆盖工具、消息、数据处理等场景。

多 AI 支持

无缝切换 Anthropic、DeepSeek、MiniMax 等多种 AI 提供商，统一 API 接口。

流式输出

实时流式响应，即时反馈。完美适配交互式应用和聊天界面。

子 Agent 系统

创建层级式 Agent 结构，主 Agent 可将任务委托给专业子 Agent。

Ambient Agent

持续后台运行的 Agent，支持目标管理、主动监控和定时任务。

记忆系统

持久化对话历史，支持语义搜索。Agent 可跨会话记忆和召回信息。

架构设计

简洁而强大

基于清晰架构构建，分离关注点，同时保持灵活性和可扩展性。

分层上下文

三层隔离，互不干扰

Request Context - 请求级链路追踪、超时控制
Session Context - 会话级消息、变量、元数据
Agent Context - Agent 级工具、技能、系统提示

Framework 层

容器层，核心管理

pluginManager - 插件生命周期管理
toolRegistry - 工具注册与执行
skillManager - 技能加载与管理
eventEmitter - 事件总线

Agent 层

对话层，AI 交互

chat() - 发送消息
chatStream() - 流式响应
工具调用 - 来自 Framework
事件系统 - 消息/工具事件

src/
├── core/           # Framework、Agent、PluginManager、ToolRegistry
├── capabilities/   # SkillManager、WorkflowEngine
├── executors/      # MCPExecutor MCP 服务器集成
└── utils/          # EventEmitter、logger

plugins/            # 内置插件（40+ 插件）
cli/bin/           # CLI 入口
examples/          # 示例代码
.agent/            # 用户配置（插件、技能、子 Agent）
skills/            # 技能目录
docs/              # 文档

插件生态

40+ 内置插件

全面的插件生态系统，覆盖工具、消息、数据处理和热门服务集成。

核心系统

ai

AI 对话能力，多提供商支持

核心

session

多会话管理、隔离、历史

核心

storage

键值对持久化存储

核心

scheduler

定时任务调度，Cron 表达式

核心

执行工具

shell

Shell 命令执行

工具

python

Python 代码执行

工具

mcp

Model Context Protocol

工具

file-system

文件系统操作

工具

即时通讯

Telegram Bot 对话

通讯

feishu

飞书 WebSocket 消息

通讯

weixin

微信网页账号对话

通讯

email

SMTP/IMAP 邮件收发

通讯

智能代理

subagent

子 Agent 隔离管理

代理

ambient-agent

持续后台运行、目标管理

代理

think

LLM 自我唤醒、持续思考

代理

memory

四层记忆系统

代理

服务与扩展

web

HTTP 服务、Webhook 接收

服务

gate-trading

Gate.io 加密货币交易

交易

audit

日志记录、审计统计

运维

rules

行为规则引擎

规则

高级功能

coordinator

多 Worker 协作调度

高级

python-plugin-loader

Python 插件加载器

高级

extension-executor

扩展插件执行器

高级

plugin-manager

插件生命周期管理

核心

快速开始

几分钟内快速上手

安装 Foliko，创建你的第一个 Agent，只需几分钟。

安装

npm install -g foliko

配置 AI

# 创建 .env 文件
touch .env

# MiniMax 配置
FOLIKO_PROVIDER=minimax
MINIMAX_API_KEY=sk-your-api-key

# DeepSeek 配置
FOLIKO_PROVIDER=deepseek
DEEPSEEK_API_KEY=sk-your-api-key

启动对话

foliko chat

编程使用

const { Framework } = require('foliko')

const framework = new Framework()
framework.loadPlugin('ai')

const agent = framework.createAgent({
  systemPrompt: '你是一个有帮助的助手'
})

const result = await agent.chat('你好')
console.log(result.message)

代码示例

丰富的示例代码

从基础到高级，19+ 示例覆盖各种使用场景。

基础

basic.js

最简单的基础示例，展示 Foliko 的核心用法

const { Framework } = require('foliko')
const framework = new Framework()
const agent = framework.createAgent()
const result = await agent.chat('Hello')

高级

ambient-example.js

Ambient Agent 完整示例，目标管理与持续运行

// 创建持续运行的目标
const goal = await ambient.goals({
  action: 'create',
  title: '监控新邮件',
  description: '每小时检查新邮件'
})

集成

test-telegram.js

Telegram Bot 集成示例

framework.loadPlugin('telegram', {
  botToken: process.env.TELEGRAM_BOT_TOKEN
})

集成

test-weixin-feishu.js

微信和飞书消息推送集成

framework.loadPlugin('weixin')
framework.loadPlugin('feishu')

工作流

workflow.js

多步骤工作流编排示例

const workflow = await agent.workflow([
  { task: '分析需求' },
  { task: '生成代码' },
  { task: '执行测试' }
])

技能

skill-example.js

自定义技能加载与使用

await agent.loadSkill('my-skill')
const result = await agent.chat('使用技能')

MCP

mcp-example.js

Model Context Protocol 服务器集成

framework.loadPlugin('mcp', {
  servers: ['fetch', 'filesystem']
})

Web

test-web-plugin.js

Web 服务与 Webhook 接收

framework.loadPlugin('web', { port: 3000 })
framework.web.registerWebhook('/hook', handler)

轻松构建智能 Agent