elizaOS：面向自主 AI 智能体的开源 TypeScript 框架与产品栈

工具定位

elizaOS 是一个开源 TypeScript 框架与产品栈，目标场景是自主 AI 智能体。该单体仓库包含核心运行时、面向用户的 Eliza 应用、CLI、云服务、原生桥接以及官方插件。

主要组件

• Eliza 应用：面向 Web、桌面和移动端的智能体应用。其能力由运行时和已安装插件提供，涉及聊天、语音、记忆、知识与文档流程、消息与工作区连接器、日历/提醒/收件箱等个人助理领域、浏览器与桌面自动化、设备原生桥接、非托管 EVM 与 Solana 钱包操作，以及定时工作流等。实际可用性取决于操作系统、插件、权限和模型/服务提供商配置。
• 框架：与模型无关，通过插件扩展。@elizaos/core 定义 AgentRuntime、类型、授权、记忆与状态原语及插件契约；@elizaos/agent 围绕核心运行时组装独立智能体与 HTTP 后端；@elizaos/app 提供服务托管与平台编排；@elizaos/ui 提供共享 React UI。插件可注册 action、provider、evaluator、service、模型处理器、路由、事件、测试和 app 视图。
• 本地推理：由 @elizaos/plugin-local-inference 提供 Eliza-1 设备端路径。当前 registry 包含基于 Gemma 4 的 2B、4B、9B、27B 文本档位，以及本地嵌入、语音、视觉和图像生成资产。硬件检测与模型路由会选择受支持的后端；所需资产下载完成后，符合条件的操作可在无网络连接下运行。不支持本地推理的硬件不会被强制启用。
• Eliza Cloud：可选服务，提供账户与认证、托管模型路由、应用与智能体部署、远程连接和跨设备服务；本地运行时和直连模型提供商仍是正式支持的路径。
• elizaOS 发行版：packages/os 负责可引导的 Linux 与 AOSP 发行版、安装器、发布清单和 OS 工具链。

从源码运行

仓库在 package.json 中固定 Bun 与 Node 版本，需先安装对应版本，然后克隆仓库并执行 bun install、bun run dev。bun install 还会准备子模块与补丁、配置受支持的宿主机构建前置条件，并构建或校验桌面端 libelizainference；嵌入用 GGUF 由运行时管理，在本地推理预热时自动下载。归档工件夹具需用指定脚本显式获取。

常用命令包括 bun run dev:local（应用加 API，本地智能体与自有提供商密钥，无需云登录）、bun run start（仅 API 的独立智能体主机）、bun run build、bun run verify、bun run test、bun run test:e2e 和 bun run cloud:mock。

基准测试

基准测试需要 Python 3.11 及以上，并安装所选套件依赖；在仓库根目录通过 PYTHONPATH=packages python3 -m benchmarks.orchestrator 的子命令列出和运行基准。实时基准需要所选提供商的凭据，可能产生调用费用。

贡献限制

贡献规则适用于所有 issue 和 PR：issue 必须由人手动提交，智能体不得代拟；须在获批的 MVP 与 PRD 范围内工作；新功能需维护者讨论批准并先更新两份计划；UI PR 需提供视频讲解与走查、桌面与移动截图及视觉审计；issue 与 PR 使用 ASD-STE100 简化技术英语撰写。项目不再接受第三方插件或 registry 条目。许可证为 MIT。