项目文件夹

0
wehub-resource-sync c2ebfdd104
ci / test (push) Has been cancelled
ci / lint-and-format (push) Has been cancelled
ci / build (push) Has been cancelled
ci / dev-startup (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
gitleaks / gitleaks (push) Has been cancelled
Markdown Links / Relative Markdown Links (push) Has been cancelled
Quality (Extended) / Homepage Build (PR smoke) (push) Has been cancelled
Quality (Extended) / Comment-only diff guard (push) Has been cancelled
Quality (Extended) / Format + Type Safety Ratchet (push) Has been cancelled
Quality (Extended) / Develop Gate (secret scan + UI determinism) (push) Has been cancelled
Quality (Extended) / Develop Gate (lint) (push) Has been cancelled
supply-chain / sbom (push) Has been cancelled
supply-chain / vulnerability-scan (push) Has been cancelled
docs: make Chinese README the default
2026-07-13 10:38:32 +00:00

Note

本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

elizaOS

elizaOS

你的智能体操作系统。

首页 · Web 应用 · 安装 OS · 文档 · 应用目录

这是什么?

elizaOS 是一款开源、本地优先(local-first)的 AI 智能体操作系统。由两部分组成:

  • Eliza — 应用。面向桌面、移动端和 Web 的 AI 助手:聊天、语音、你的消息账号、个人助理大脑、非托管钱包、浏览器自动化,以及端侧模型。
  • elizaOS — 底层运行时与操作系统。同一套运行时能够接管整台设备 —— 启动 Linux 桌面,或在 Android 上作为系统助手运行。

智能体、你的数据和模型都在你的设备上运行。Eliza Cloud 为可选 —— 可添加托管推理、同步与部署能力。

获取 Eliza

平台 方式
Web 打开 app.elizacloud.ai
Desktop — macOS · Windows · Linux GitHub Releases 下载
iOS · Android App Store · Play · 侧载(sideload

从源码运行:

git clone --filter=blob:none https://github.com/elizaos/eliza.git
cd eliza
bun install
bun run dev          # API + the Eliza app UI

若要将整台设备作为 elizaOS 运行,请参阅 elizaOS — 操作系统

Eliza 能做什么

应用内置:

  • 💬 Chat — 智能体与各账号的统一收件箱(iMessage、Discord、Telegram、WhatsApp、Slack、Farcaster、X)。
  • 🎙️ Voice — 免提语音,端侧转写与自然语音合成。
  • 📇 Phone · Messages · Contacts — 电话与短信界面(Android 原生)。
  • 🧠 Personal assistant — 日历、提醒、收件箱分拣、任务、每日简报,以及经所有者批准的操作。
  • 🌐 Browser & computer use — 智能体驱动真实浏览器与桌面。
  • 👛 Wallet — 非托管 EVM + Solana:转账、兑换、跨链桥、LP。每笔支出均需你确认。
  • 📄 Documents — 针对文件提问(RAG)。
  • 📷 Camera & vision — 拍摄图像并进行推理。
  • ⚙️ Automations — 安排周期性任务;选择模型与路由。

默认私密

Eliza 可通过端侧模型家族 Eliza-1(Gemma-4)在设备上运行完整流水线:

  • Text — 文本生成与嵌入,规模约 2B(手机)至约 27B(桌面)。
  • Voice — 本地语音转文字与文字转语音;音频永不离开设备。
  • Vision & images — 端侧描述与生成。

Settings → Model Routing(设置 → 模型路由)中选择模型后会下载并固定;此后无需网络即可使用。

elizaOS 上的应用

elizaOS 运行的是应用,而不仅是智能体。应用是一种插件,会在 Eliza 内新增界面;运行时像真实软件一样安装、启动并跟踪,重启后依然保留。

elizaOS — 操作系统

packages/os 是真正的可启动发行版。下载与硬件信息见 os.elizacloud.ai.

  • Linuxpackages/os/linux)— 从 U 盘启动内置 Eliza 的完整桌面。amd64 · arm64 · riscv64。
  • Androidpackages/os/android)— Eliza 作为系统启动器与助手,运行于 Pixel 级别设备。

该 OS 现已可启动;完整设备认证与正式更新渠道仍在推进中 —— 各目标平台的 README 可查看状态。

Eliza Cloud(可选)

可选的托管后端,用于突破单设备限制。绝非必需 —— 仅本地运行是一等公民方案。它提供:

  • Auth — 账号与登录(OAuth/SIWS)。
  • Hosted inference — 跨服务商的模型路由,按使用量计费。
  • Deploy — 将智能体或应用部署到拥有独立域名的容器。
  • Sync & bridge — 跨设备状态同步;从云端控制台驱动本地智能体。
  • Monetization — 对已发布应用、智能体与 MCP 进行计量与创作者收益分成。

基于 elizaOS 构建

运行时为开源,可自行扩展。从 CLI 开始:

bun add -g elizaos@beta
elizaos create my-app --template project   # a deployable app workspace
elizaos create my-plugin -t plugin         # a runtime plugin (action/provider/service)

运行时与模型无关model-agnostic)(OpenAI、Anthropic、Gemini、Grok、Llama、本地 Eliza-1 等),通过少量原语扩展:

  • @elizaos/corepackages/core)— 智能体循环、插件模型,以及消息/记忆/状态原语。
  • @elizaos/agentpackages/agent)— AgentRuntime、插件加载器与默认插件映射。
  • @elizaos/app-corepackages/app-core)— 运行智能体的 API + 控制台宿主。
  • elizaospackages/elizaos)— CLIcreateinfoupgrade

插件(plugin 导出 Plugin,用于注册 actions(智能体执行的操作)、providers(提示上下文)、services(长生命周期单例)与 evaluators(响应后处理)。直接导入 @elizaos/core 即可在无 CLI 或 UI 的情况下使用运行时 —— 参见 packages/examples 以及 packages/benchmarks 中的评测套件。完整指南:docs.elizaos.ai.

在 monorepo 中开发

bun install            # workspace install
bun run install:light  # skip the large artifact download when disk or time is tight
bun run dev            # API + Vite UI for apps/app
bun run build          # turbo build across the workspace
bun run test           # full test suite
bun run cloud:mock     # boot the local cloud backend stack with mocks

本仓库自包含 —— 运行时、CLI、控制台、原生 OS 分支、云端后端与官方插件均在此。每个包都有各自的 README.md;进入开发前请先阅读。目录结构见 AGENTS.md

贡献

欢迎贡献。提交非平凡 PR 前请先开 issue。开 PR 前请阅读 CONTRIBUTING.md 以及 AGENTS.md 中的证据标准;可前端测试的变更需在 PR 正文中附上截图(JPG)、MP4 视频演示、日志,以及任何相关的真实 LLM 轨迹。通过 GitHub Project 看板协作的 Agent 与维护者,在认领看板任务前须遵循 CONTRIBUTING.md 中的协调流程。当前 MVP 工作在 LifeOps Personal Assistant MVP 看板 以及 Discussions; 中协调;进行中的设计文档见 packages/docs/ongoing-development/

如需报告安全漏洞,请遵循 SECURITY.md;请勿公开提交 issue。

License

MIT — 参见 LICENSE