# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Nico Albanese (@nicoalbanese10) · 平台：X (Twitter) · 日期：2026-04-14

> 原始來源：https://x.com/nicoalbanese10/status/2043745569278251112

## 中文摘要

Open Agents開源雲端程式碼Agent平台，作者三個月內全靠它撰寫所有程式碼。

作者三個月前開始打造雲端運行的程式碼Agent，此Agent已撰寫所有他發佈的程式碼，包括自身程式碼，如今開源為「Open Agents」，徹底改變其工作流程，讓他從瀏覽器端到端完成一切發佈。作者厭倦本地運行Agent的麻煩，如管理worktrees、保持筆電開啟避免休眠，於是建構雲端平台，可同時啟動多個Agent平行運行，工作階段無時間限制，數百次工具呼叫橫跨數小時，關閉筆電也能持續進行。

**平台架構與核心決策**  
Open Agents為三層系統：Web → Agent workflow → Sandbox VM。  
Web應用處理認證、工作階段、聊天與串流UI；Agent以Vercel上的持久化workflow運行；沙盒為執行環境，包含檔案系統、shell、git、開發伺服器與預覽連接埠。  
關鍵架構決策：Agent不運行於沙盒內，而是外部透過工具（如檔案讀取、編輯、搜尋、shell指令）互動，此分離確保：  
- Agent執行不綁定單一請求生命週期  
- 沙盒生命週期可獨立休眠與恢復  
- 模型/供應商選擇與沙盒實作可獨立演進  
- VM維持純執行環境，而非控制平面  

**當前功能與執行細節**  
聊天驅動的程式碼Agent支援多項工具，具備持久化多步驟執行。  
- chat驅動程式碼Agent，內含檔案、搜尋、shell、工作、技能與web工具  
- Workflow SDK支撐的持久化多步驟執行  
- Vercel沙盒的隔離環境，基於快照恢復  
- 沙盒內repo複製與分支工作  
- 成功運行後的選用自動commit、push與PR建立  
- 唯讀連結分享工作階段  
- 選用ElevenLabs語音輸入轉錄  
執行細節：聊天請求啟動workflow運行而非內聯執行；每個Agent回合可橫跨多個持久化workflow步驟；活躍運行可透過重新連線串流恢復；沙盒使用基底快照，暴露連接埠3000、5173、4321與8000，閒置後休眠；自動commit與PR為使用者偏好功能，非常開啟。

**技術堆疊與部署需求**  
平台由以下技術驅動：  
- AI SDK - Agent harness  
- ▲ AI Gateway - 數百模型內建fallback  
- ▲ Sandbox - 安全、隔離且持久化VM  
- Workflow DevKit - 持久化且近乎無限執行  
最低運行需求：POSTGRES_URL與JWE_SECRET，用於啟動應用與載入伺服器狀態。  
完整部署需token加密與Vercel OAuth：ENCRYPTION_KEY、NEXT_PUBLIC_VERCEL_APP_CLIENT_ID、VERCEL_APP_CLIENT_SECRET，否則Vercel登入失效。  
GitHub repo存取、push與PR需：NEXT_PUBLIC_GITHUB_CLIENT_ID、GITHUB_CLIENT_SECRET、GITHUB_APP_ID、GITHUB_APP_PRIVATE_KEY、NEXT_PUBLIC_GITHUB_APP_SLUG、GITHUB_WEBHOOK_SECRET。  
選用：REDIS_URL、KV_URL、VERCEL_PROJECT_PRODUCTION_URL等。  
部署步驟：fork repo、建PostgreSQL資料庫、產生JWE_SECRET與ENCRYPTION_KEY、匯入Vercel、設定環境變數、建立Vercel OAuth app與GitHub App。  
本地設定：bun install、複製.env範例、填入必要值、bun run web。  
Repo結構：apps/web（Next.js app、工作流程、認證、聊天UI）、packages/agent（Agent實作、工具、子Agent、技能）、packages/sandbox（沙盒抽象與Vercel整合）、packages/shared（共享工具）。

**作者使用心得與貢獻**  
作者大量使用後無法想像回頭，稱其為「我建過的最佳東西」，每日迭代數月，展示完整使用範例：https://open-agents.dev/u/nicoalbanese、工作階段範例：https://open-agents.dev/shared/JqlQ1TbehOkm。雖然設計為程式碼用途，但易適應其他領域，鼓勵fork自訂：https://vercel.com/templates/template/open-agents。  
特別感謝@willsather超越作者內部排行榜（作者上週還第一😂），發佈git panel、CI auto fix、file viewer、重設計側邊欄等最佳更新；@nishimiya建構出色首頁。立即試用：https://open-agents.dev。

## 標籤

Agent, 開源專案, CLI, Open Agents
