elizaOS：开源自主智能体操作系统与 TypeScript Agent 框架
elizaOS 是一个面向自主 AI 智能体的开源 TypeScript 框架与产品栈，仓库以 monorepo 形式包含核心运行时、Eliza 应用、CLI、云服务、原生桥接与一方插件；可引导的 Linux 与 Android 发行版位于独立的 elizaOS/os 仓库。框架与模型无关，通过插件扩展，并支持本地推理、直连模型提供方或 Eliza Cloud 多种后端路由。
社区作者 · zZz
它解决什么问题
elizaOS 定位为「你的智能体操作系统（Your agentic operating system）」。它是一个面向自主 AI 智能体的开源 TypeScript 框架与产品栈，本 monorepo 包含核心运行时、Eliza 应用、CLI、云服务、原生桥接以及一方插件。可启动的 Linux 与 Android 发行版位于独立的 elizaOS/os 仓库中。配图 1 为 elizaOS 项目横幅（elizaos_banner.svg）。
【入门路径】按目标选择起点：使用 Eliza → 打开 Web 应用、访问 Eliza downloads 或使用已发布的 GitHub Release；运行本仓库 → 按「从源码运行 Eliza」操作；构建智能体或插件 → 安装 elizaos CLI 并阅读开发者文档；贡献代码 → 阅读 CONTRIBUTING.md 与仓库指南 AGENTS.md；把整台设备作为 elizaOS 运行 → 使用 elizaOS/os 中的安装器与目标指南。
【技术栈组成 · Eliza】Eliza 是面向 Web、桌面与移动端的用户侧智能体应用，其能力由运行时和已安装插件提供，包括：聊天、语音、记忆、知识与文档工作流；消息与工作区连接器；日历、提醒、收件箱、目标、健康等个人助理领域；浏览器与桌面自动化；摄像头、电话、短信、联系人、位置等原生设备桥接；带审批边界的非托管式 EVM 与 Solana 钱包操作；以及定时工作流、编码智能体编排和可安装的应用视图。能力是否可用取决于操作系统、已安装插件、已授予权限以及配置的模型或服务提供方，各能力的确切支持与配置以包级 README 为准。
【框架】框架与模型无关，通过插件扩展：@elizaos/core 定义 AgentRuntime、规范类型、消息循环、记忆与状态原语以及插件契约；@elizaos/agent 围绕核心运行时组装独立智能体与 HTTP 后端；@elizaos/app-core 为 Eliza 各应用目标提供共享的应用托管、API 与平台编排；@elizaos/ui 提供应用界面共用的 React UI；elizaos 是项目与插件的脚手架、升级与部署 CLI。
插件导出 Plugin 对象，可注册 actions、providers、evaluators、services、模型处理器、路由、事件、测试与应用视图。
【本地推理】@elizaos/plugin-local-inference 提供 Eliza-1 的端侧推理路径。当前 Eliza-1 注册表包含基于 Gemma 4 的 2B、4B、9B、27B 文本档位，以及本地嵌入、语音、视觉与图像生成资产。硬件检测与模型路由会选取受支持的后端；在所需资产下载完成后，符合条件的操作可在无网络连接下运行。本地推理不会在不支持的硬件上被强制执行，每种模型能力都可路由到本地、直连提供方或 Eliza Cloud 后端。
【Eliza Cloud】Eliza Cloud 为可选组件，提供账号与认证服务、托管模型路由、应用与智能体部署、远程连接以及跨设备产品服务；本地运行时与直连模型提供方配置始终是一等路径。
【发行版】独立的 elizaOS/os 仓库负责可启动 Linux 与 AOSP 发行版、安装器、发布清单和操作系统工具链；本 monorepo 保留桌面、iOS、Android 与设备集成所使用的 Eliza 应用外壳与原生运行时桥接。
【仓库结构】packages/ 为运行时、宿主、UI、CLI、文档、云、原生代码与工具链；plugins/ 为一方模型、连接器、领域、应用与设备插件；scripts/ 为仓库级检查、测试编排与发布工具；patches/ 为安装期间应用的依赖补丁。每个维护中的包或插件应在其 README.md 及配套的 CLAUDE.md / AGENTS.md 中说明公开接口、脚本、配置与本地约束，改动前应先阅读最近的包指南。
【贡献与安全】非平凡改动请先开 issue，并通过针对 develop 分支的 pull request 提交；CONTRIBUTING.md 定义了协作、测试、同步与可人工验证证据的要求。漏洞请通过安全政策私下报告，不要开公开 issue。许可证为 MIT。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、准备环境
- 本仓库在 package.json 中固定（pins）了 Bun 与 Node 版本，请先安装与之一致的 Bun 和 Node 版本，再执行后续命令。
步骤 2 · 说明：
bun install 会同时准备子模块与补丁（patches）、为受支持的宿主机安装构建前置依赖，并构建或校验已暂存的桌面端 libelizainference。嵌入用的 GGUF 由运行时管理，会在本地推理预热（local-inference warmup）期间自动下载。如需归档产物夹具（archived artifact fixtures），需显式执行
bun run fetch:archive-artifacts。
二、从源码运行 Eliza（Run Eliza from source）
git clone --filter=blob:none https://github.com/elizaos/eliza.gitcd elizabun installbun run dev三、常用仓库命令
bun run build # 使用 Turbo 构建整个工作区bun run verify # 包一致性（parity）、依赖、类型、lint 与审计门禁bun run test # 仓库单元/集成测试通道bun run test:e2e # 端到端测试通道bun run cloud:mock # 带 mock 的本地 Eliza Cloud 栈另见 AGENTS.md 了解包作用域划分、共享开发服务器，以及一次改动被视为完成前所需的证据要求。
四、使用 elizaos CLI 构建项目与插件 当前分支发布的是 beta CLI，使用未加作用域的 elizaos 包：
bun add --global elizaos@betaelizaos create my-project --template project elizaos create plugin-example --template plugin 其中 projects 是可部署的工作区，plugins 是可复用的能力包；打包模板与脚手架契约位于 packages/elizaos/templates/。
五、不经 CLI 或应用宿主直接嵌入运行时 直接导入 @elizaos/core 即可嵌入运行时；场景运行器（scenario runner）提供针对真实运行时的可执行集成覆盖，并在已配置时对接在线模型。
六、其他入门方式
- 只想使用 Eliza：打开 Web 应用、访问 Eliza downloads，或使用已发布的 GitHub Release。
- 想把整台设备作为 elizaOS 运行：使用 elizaOS/os 仓库中的安装器与目标指南。
- 想贡献代码：先阅读 CONTRIBUTING.md 与 AGENTS.md，非平凡改动先开 issue，再向 develop 分支提交 pull request。
七、首次运行与常见问题
- 本地推理不会在不支持该能力的硬件上被强制执行；硬件检测与模型路由会把每项模型能力分配到本地、直连提供方或 Eliza Cloud 后端。
- 功能是否可用取决于操作系统、已安装插件、已授予权限以及配置的模型或服务提供方，具体支持与配置请查阅对应包级 README。
- Eliza Cloud 为可选，本地运行时与直连模型提供方配置始终可用。
- 安全漏洞请通过安全政策私下报告，不要在公开 issue 中披露。
- Windows 环境设置见仓库链接的 Windows setup 文档。
来源教程配图
