eliza：开源 AI 代理框架

1. 项目概述

eliza 是一个用于构建自主 AI 代理的开源 TypeScript 框架——这些软件实体可以聊天、记忆上下文、使用工具，并在 Discord、Telegram 和区块链等平台上执行操作，而无需开发者从头编写集成代码。

2. 背景与定位

elizaOS 的创建旨在为开发者提供一个易于上手且可扩展的基础，用于构建能够在多种界面（网页、桌面、移动端和消息平台）上一致运行的 AI 代理，同时通过本地设备端推理来保障用户自主权，并在需要时保护隐私。其核心使命是让代理开发变得像编写插件一样简单，而不是为每个平台和模型提供商定制集成方案。

与单一用途的聊天机器人 SDK 或封闭的代理平台不同，elizaOS 具有以下特点：

以运行时为中心，而非以应用为中心——共享的 @elizaos/core 运行时负责处理记忆、消息循环和代理状态，因此同一个代理定义可以以 Discord 机器人、网页应用或命令行进程的形式运行。
模型无关——代理可以调用云端模型提供商，也可以通过 Eliza-1 模型注册表运行本地模型（2B–27B 参数），让团队在便利性和完全本地控制之间做出选择。
深度可插拔——几乎所有代理能力（平台连接器、区块链钱包、工具）都通过一个由社区维护的大型插件生态系统提供，而非硬编码在框架中。

3. 功能分类

🔌 平台连接器——90+ 插件，示例：Discord、Telegram、Slack、Twitter/X、Farcaster。用途：让同一个代理定义能够在聊天和社交平台上原生运行。
⛓️ 区块链与钱包——示例：Ethereum 插件、Solana 插件、非托管钱包操作、交易审批流程。用途：允许代理在明确且受限的用户批准下持有和使用加密钱包。
🧠 模型与推理——示例：Eliza-1 本地模型注册表、云端模型提供商适配器、Eliza Cloud 模型路由。用途：让开发者在本地私有推理和托管式云端路由推理之间做出选择。
🧩 代理运行时原语——示例：Actions、Providers、Evaluators、Services、Characters。用途：每个插件注册的可组合构建块，构成代理的行为和个性。
🗓️ 生产力与实用工具集成——示例：日历访问、提醒、文档/知识处理、自动化工具。用途：将代理从单纯对话扩展到实用的日常任务辅助。

4. 核心亮点

角色驱动的个性——代理的行为和语气通过“角色”文件以声明式方式定义，将个性配置与运行时代码分离。
Actions、Providers 和 Evaluators 模型——清晰区分代理可以做什么（actions）、可以引入什么上下文（providers）以及如何评估自身响应（evaluators），使插件行为可预测且可组合。
本地优先的推理选项——Eliza-1 模型注册表让代理可以完全在设备端运行，这对有隐私或离线需求的团队非常重要，同时也可选云端路径。
非托管区块链支持——EVM 和 Solana 链上的钱包操作受明确的批准边界约束，而非不受限制的交易签名。
多平台应用套件——除了框架本身，elizaOS 还提供网页、桌面、移动端甚至可启动的操作系统发行版，因此同一个代理可以部署给最终用户，而不仅仅是开发者。
大型第一方插件生态系统——90+ 插件覆盖消息平台、区块链和设备桥接，减少了大多数项目需要编写的自定义集成代码量。

5. 按角色划分的用例

普通开发者——通过组合现有插件（Discord、Telegram、日历）构建自定义聊天或自动化代理，而无需手动编写平台 SDK。
数据/研究科学家——使用知识处理和文档处理工作流，结合本地模型推理，试验检索和记忆增强代理，而无需将数据发送给第三方 API。
项目经理——以最少的自定义代码部署用于日历管理、提醒和跨平台协调（例如 Discord/Slack 助手）的代理。

6. 快速开始

查找所需内容——浏览插件注册表和文档：

https://docs.elizaos.ai/

安装/集成——克隆仓库并启动开发环境：

git clone --filter=blob:none https://github.com/elizaos/eliza.git
cd eliza
bun install
bun run dev

贡献——开启一个 issue 讨论非平凡的更改，然后向 develop 分支提交拉取请求：

git clone https://github.com/elizaos/eliza.git

完整要求请参阅仓库中的 CONTRIBUTING.md。

7. 项目结构

eliza/
├── packages/
│   ├── core/          # @elizaos/core — 运行时、类型、消息循环、记忆原语
│   ├── agent/          # @elizaos/agent — 独立代理进程和 HTTP 后端
│   ├── app-core/        # @elizaos/app-core — 应用托管和编排
│   ├── ui/              # @elizaos/ui — 共享 React 组件
│   └── cli/              # 用于搭建和运行代理的命令行工具
├── plugins/               # 第一方插件（平台连接器、区块链、模型）
├── scripts/                # 仓库维护工具
└── patches/                 # 依赖补丁

packages/core 运行时是其他所有包和插件构建的共享基础；plugins/ 是开发者添加或发现新代理能力的主要位置。

8. 相关生态

Eliza Cloud——一个可选的托管平台，为使用开源框架构建的代理提供认证、模型路由和部署服务。
Eliza-1 模型注册表——一组可插入运行时模型处理接口的本地模型（2B–27B 参数），用于设备端推理。
模型提供商和消息平台——插件系统连接到 Discord、Telegram、Slack 和区块链网络（Ethereum、Solana）等第三方服务，这些服务是独立运营的，不属于 elizaOS 项目。

9. 许可证

✅ 允许在 MIT 许可证下使用、修改和分发 eliza，包括商业用途。
✅ 允许分叉该项目并在此基础上构建专有代理或产品。
❌ 不得从软件的副本或实质性部分中删除原始版权和许可证声明。
ℹ️ MIT 不提供任何担保；在生产环境中依赖 eliza 之前请审阅许可证文本，并在插件连接第三方付费服务时检查各个插件的许可证。

10. 常见问题

问：运行代理是否必须使用 Eliza Cloud？
答：不需要。Eliza Cloud 是可选的；代理可以完全本地运行，也可以使用您自己配置的模型提供商。

问：代理能否在不向任何云端模型提供商发送数据的情况下运行？
答：可以，通过 Eliza-1 本地模型注册表即可，该注册表支持 2B–27B 参数范围内模型的设备端推理。

问：如何为新的聊天平台添加支持？
答：构建或安装一个导出 Plugin 对象的插件，该对象注册相关的 actions、providers 和 services——请参阅 docs.elizaos.ai 上的插件文档。

问：eliza 开箱即用支持哪些区块链？
答：第一方插件目前覆盖 EVM 兼容链和 Solana，非托管钱包操作受明确的批准边界约束。

问：在哪里报告 bug 或提出功能建议？
答：根据 CONTRIBUTING.md，在提交非平凡的拉取请求之前，请在 GitHub 仓库中开启一个 issue。

11. 快速链接

仓库：https://github.com/elizaOS/eliza
文档：https://docs.elizaos.ai/
贡献指南：https://github.com/elizaOS/eliza/blob/develop/CONTRIBUTING.md
Issues：https://github.com/elizaOS/eliza/issues

12. 总结

eliza 为开发者提供了一个模型无关、插件驱动的运行时，用于构建在聊天平台、区块链以及本地或云端推理后端上一致运行的 AI 代理。它对于希望快速交付多平台代理而无需为每个消息服务或模型提供商手动编写集成的团队，以及希望拥有完全本地私有推理选项的开发者来说，最具价值。