elizaOS/eliza · 上手攻略

仓库：elizaOS/eliza
链接：https://github.com/elizaOS/eliza
分类：AI · Agent 框架
作者：Tom
更新：2026-07-14

是什么

elizaOS/eliza 是一个开源、本地优先的 AI Agent 操作系统。它由两部分组成：

Eliza（应用层）：面向桌面、移动端、Web 的 AI 助手，支持聊天、语音、消息账户集成、个人大脑、非托管钱包、浏览器自动化和本地模型。
elizaOS（运行时/OS 层）：同一个运行时可以接管整台设备，从 USB 启动 Linux 桌面，或在 Android 上作为系统级助手。

数据、Agent、模型都运行在本地设备上，这是第一优先级的设计原则。Eliza Cloud（托管后端）是可选的，仅在需要托管推理、同步和部署时才启用。

解决什么问题

主流 AI Agent 往往依赖云端 API，数据隐私无法保障，且各功能散落在不同工具里。eliza 的目标是：

一站式 Agent：聊天、语音、钱包、浏览器自动化、文档 RAG、相机视觉、任务自动化全部集成。
本地优先：模型和数据不必须离开设备，支持 Gemma-4（Eliza-1）本地推理。
跨平台：Desktop（macOS/Windows/Linux）、iOS、Android、Web 全平台覆盖。
Plugin 生态：90+ 官方插件，支持自定义扩展。

快速安装

桌面预编译包（推荐新手）

直接下载 GitHub Releases 中的安装包： - https://github.com/elizaOS/eliza/releases

支持 macOS（amd64/arm64）、Windows（x64）、Linux（amd64/arm64/riscv64）。

从源码运行（开发者模式）

前置要求：Node.js ≥ 18 + Bun 已安装。

# 克隆仓库（不下载历史 blob，节省时间）
git clone --filter=blob:none https://github.com/elizaos/eliza.git
cd eliza

# 安装依赖
bun install

# 启动开发服务器（API + Vite UI）
bun run dev

启动后访问 http://localhost:3000 即可看到 Eliza 应用界面。

全局 CLI 方式（2025 年新版工作流）

# 全局安装 CLI
bun i -g @elizaos/cli

# 创建新项目（交互式引导）
elizaos create

# 启动
elizaos start

⚠️ 注意：CLI 方式 (@elizaos/cli) 是 beta 版本，命令和参数可能随版本变化，建议 clone 源码方式锁定版本。

核心用法

多平台聊天集成

Eliza 支持同时连接多个消息平台，在 Settings → Accounts 中配置，每个平台需要对应的 Bot Token：

平台	配置项
Discord	Bot Token + Guild ID
Telegram	Bot Token
WhatsApp	手机号 + 微信（需企业账号）
Slack	Bot Token + Workspace
X (Twitter)	API Key + API Secret
iMessage	macOS 本地（需运行在 Mac 上）

创建 Agent 角色（Character File）

角色定义文件（TypeScript）位于项目根目录或 characters/ 目录：

// characters/tutorial-bot.ts
import { Character } from "@elizaos/core";

export default {
  name: "TutorialBot",
  version: "0.1.0",
  description: "A helpful assistant for new users",
  bio: "I'm here to help you get started with elizaOS!",
  topics: ["getting started", "tutorials", "help"],
  style: {
    all: ["helpful", "friendly", "concise"],
    chat: ["conversational", "patient"],
  },
  // 模型路由，默认使用 GPT-4
  modelProvider: "openai",
  // 接入的插件
  plugins: [],
} satisfies Character;

Plugin 系统

elizaOS 的 Plugin 导出四个核心概念：

Actions（动作）：Agent 执行的具体操作，如发送消息、转账
Providers（上下文提供者）：为每次推理注入额外上下文
Services（长生命周期服务）：如 Twitter 服务、语音服务
Evaluators（评估器）：响应后的校验和反思

// 官方插件示例
// plugin-browser: 浏览器自动化
// plugin-documents: 文档 RAG
// plugin-phone: 电话/SMS（Android）
// plugin-task-coordinator: 任务协调

安装第三方 Plugin：

# 从插件市场浏览
# https://plugins.elizacloud.ai

# 本地开发新插件
elizaos create my-plugin -t plugin

本地模型（Eliza-1 / Gemma-4）

Settings → Model Routing 中选择本地模型，Eliza-1 会自动下载并固定在本地（~2B 到 ~27B 参数，适配手机到桌面）。本地运行后无需网络即可推理，语音也在设备端完成 STT/TTS，音频不离开设备。

钱包功能

支持 EVM（以太坊系）+ Solana，典型操作：

转账：transfer 0x... 1.0 ETH（需主人确认）
Swap：通过 DEX 合约兑换
Bridge：跨链桥接

所有链上操作需要主人显式批准，非托管设计，私钥始终在本地。

典型适用场景

场景	说明
个人 AI 助手	集日历、提醒、邮件/消息处理于一体的桌面/手机助手
社交媒体管理	同时运营 Discord、Telegram、X 多平台，自动回复和内容生成
链上交易	监控钱包、DEX swap、跨链桥接，全流程本地验证
浏览器 RPA	让 Agent 驱动真实浏览器完成网页操作
本地隐私场景	完全离线运行，不依赖任何云端 API
Plugin 开发	基于 Plugin 模型快速扩展 Agent 能力

坑与注意

Beta CLI 不稳定：@elizaos/cli 是 beta，建议优先用 clone + bun run dev 源码方式。
部分平台集成有门槛：iMessage 只能在 macOS 上运行；WhatsApp 需要企业账号。
elizaOS 桌面 OS 仍在推进：Linux/Android OS 分发还未完全生产化，下载页面标注"full device certification in progress"。
移动端功能有限：iOS/Android App 已有但部分功能（Phone/SMS）仅 Android 原生支持。
Plugin 生态质量参差：第三方 Plugin 未经严格审核，生产环境使用前需自行评估。
版本迭代快：文档可能滞后于代码，建议同时参考 GitHub README 最新内容。
资源占用：运行本地模型（~27B）对内存要求高（建议 16GB+ RAM 设备）。

与同类对比

特性	elizaOS/eliza	AutoGPT	LangChain	MetaGPT
本地优先	✅ 原生	❌ 依赖云	❌ 依赖云	❌ 依赖云
桌面 OS 形态	✅ 支持	❌	❌	❌
多平台集成	90+ 插件	有限	丰富	有限
Plugin 模型	✅ 四层架构	✅	✅	✅
链上钱包	✅ EVM+Solana	❌	❌	❌
学习门槛	中等	较高	中等	较高
Stars（2026-07）	~18,739	—	—	—

elizaOS 的核心差异化是操作系统级的整合：不是单纯库或框架，而是把 Agent 做成了可以引导整台设备运行的 OS，这是其他项目没有的路线。

一句话推荐结论

想在一个设备上用一个 app 搞定聊天、语音、钱包、浏览器自动和本地大模型——且数据不离开你的机器——elizaOS/eliza 是目前最接近「AI 操作系统」形态的开源实现，值得上手体验。