eliza：開源 AI 代理框架

1. 專案概覽

eliza 是一個用於建構自主 AI 代理的開源 TypeScript 框架——這些軟體實體可以聊天、記憶上下文、使用工具，並在 Discord、Telegram 與區塊鏈等平台上行動，開發者無需從零撰寫整合程式碼。

2. 背景與定位

elizaOS 的建立目的是為開發者提供一個易於使用且可擴充的基礎，用於建構能在多種介面（網頁、桌面、行動裝置與訊息平台）上一致運作的 AI 代理，同時保留使用者自主權，並在需要時透過本機端推論來保障隱私。核心使命是讓代理開發變得像撰寫外掛程式一樣容易上手，而非為每個平台與模型供應商打造客製化整合。

與單一用途的聊天機器人 SDK 或封閉式代理平台不同，elizaOS 具備以下特點：

以執行環境為核心，而非以應用程式為核心 — 共享的 @elizaos/core 執行環境負責記憶、訊息迴圈與代理狀態，因此同一個代理定義可以作為 Discord 機器人、網頁應用程式或 CLI 程序執行。
與模型無關 — 代理可以呼叫雲端模型供應商，或透過 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 還提供網頁、桌面、行動裝置，甚至可開機的 OS 發行版，因此同一個代理可以部署給終端使用者，而不僅限於開發者。
龐大的第一方外掛生態系統 — 超過 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 分支提交 pull request：

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，非託管錢包操作須遵守明確的核准邊界。

問：我應該在哪裡回報錯誤或提出功能建議？
答：請先在 GitHub 儲存庫中開啟 issue，再提交非小幅的 pull request，詳見 CONTRIBUTING.md。

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 代理。對於希望快速推出多平台代理、又不想為每個訊息服務或模型供應商手動撰寫整合的團隊，以及希望擁有完全本機、私有推論選項的開發者而言，此框架最具價值。