OpenHands

OpenHands是什麼

OpenHands是一個用於軟體開發的開源型AI Agent平台，其早期的名稱為OpenDevin。它不僅能夠在聊天框中補全代碼，還能理解開發任務、讀取代碼庫、規劃步驟、編輯檔案、執行終端指令、運行測試，並根據測試結果繼續進行修正。

使用者可透過網頁介面、終端機介面、CLI 或 Software Agent SDK 來使用，亦可選擇官方雲服務。

OpenHands採用與模型無關的設計，可連接OpenAI、Anthropic及其他相容的模型服務，同時也支援適用於智能體任務的本地模型。其核心開源版本更適合單一開發者在可信環境中使用；

團隊權限、集中計費、工單與協作整合、大規模併發以及私有雲支援則屬於 Cloud 或 Enterprise 範疇。

OpenHands核心功能

自主完成開發任務

使用者可以提出「修復此錯誤」「為介面添加測試」「遷移依賴版本」等需求，Agent會讀取儲存庫、搜尋相關檔案、修改程式碼並執行驗證。它適用於邊界清晰且能以測試來檢查的任務，但無法保證每次的改動都是正確的。

複雜架構設計、生產事故和安全敏感修改仍需工程師審查。

終端、檔案編輯和瀏覽能力

OpenHands 為智能體提供命令執行、檔案讀寫、網頁瀏覽以及開發工具，讓模型能夠觀察實際的運行結果，而非僅僅輸出程式碼片段。正因為這些功能具有較高的權限，因此運行環境必須被隔離，且只掛載任務真正需要的目錄。

Git倉庫集成

該平台可圍繞 GitHub、GitLab 和 Bitbucket 等程式碼儲存庫來運作，能夠讀取分支、建立提交記錄，或透過雲端工作流程來處理任務。在連接到儲存庫時，應使用權限最小的令牌。

對於外部貢獻或不可信的 Issue，必須防範提示注入和惡意腳本，不能讓 Agent 自動訪問生產密鑰。

Agent Canvas、網頁介面與CLI

Agent Canvas 提供瀏覽器介面及後端連線功能，讓使用者能夠在單一前端介面中切換不同的 Agent Server。喜歡使用終端機作業方式的開發者可以選擇使用 CLI，而團隊則可透過遠端伺服器，讓任務在電腦關機後仍能持續運作。

不同版本的啟動方式正在持續演進，安裝時應以當前穩定版文件為準。

Software Agent SDK

OpenHands Software Agent SDK 提供 Python 與 REST 介面，可用於定義智能體、工具及工作流程，並可在本地或雲端上運行。Agent Server 亦可提供與常見聊天客戶端相容的服務入口。

SDK適合用於建立代碼審查、依賴項目更新、問題處理以及內部開發的自動化流程，並不等同於簡單的模型聊天SDK。

MCP與外部集成

OpenHands 支援 MCP 工具方向，可讓 Agent 使用額外的資料來源與服務。Cloud 與 Enterprise 更提供 API、Slack、Jira 等整合方式。

每增加一種工具都會擴大可訪問範圍，應為不同倉庫、團隊和環境劃分獨立憑證與權限。

OpenHands價格與套餐對比

以下為官方定價頁面目前公開的方案。OpenHands軟體本身免費，並不代表整體使用成本為零：本地版通常仍需支付模型API、伺服器或GPU的費用；

雲端個人版可自帶模型金鑰，也可購買 OpenHands LLM credits 以模型成本價使用。

OpenHands LLM Provider 目前是按照模型供應商的實際成本來計費，不會有額外的加價。至於輸入、緩存輸入和輸出 token 的單價，則會根據所選模型的不同而有所差異。在生成 OpenHands LLM Key 之前，官方文件要求帳戶至少需購買 10 美元的 Cloud credits。

Cloud API Key 與 LLM Key 的用途不同：前者用於呼叫 OpenHands Cloud，後者用於呼叫其模型提供層，不應混用。

部署版本對比

開源許可與企業版區別

OpenHands 的核心專案採用 MIT 授權，可用於查看、修改，並應用於商業專案。開源版適用於單一使用者的本地環境，包含核心 Agent、介面、CLI 以及 SDK 等元件。

Enterprise 的自託管雲組件屬於 source-available，可查看源代碼，但超過試用期運行需要購買許可，不能因為代碼可見就當作 MIT 軟體。

企業版提供 30 天的試用期，並具備多使用者支援、權限控制、集中式政策管理、審計功能，以及私有 VPC 和整合與支援服務。團隊不應將單使用者的開源實例直接作為公共服務供多人使用，因為這些基礎實例並不具備完整的多租戶身份驗證、隔離及擴展功能。

OpenHands本地安裝教學

1. 檢查環境：準備符合當前文件要求的 Node.js、Python 工具鏈以及 Docker；Windows 使用者同時需確認虛擬化功能與 Docker Desktop 的安裝狀況。
2. 選擇穩定版本：優先安裝官方穩定發行版，不要在重要專案中直接使用主分支構建。
3. 準備獨立專案目錄：只把需要處理的倉庫放入專門目錄，不要把整個使用者目錄或系統磁碟掛載給 Agent。
4. 啟動沙箱：優先使用 Docker 進行隔離運行，並將服務綁定至本機迴圈地址，以避免被區域網路或公網直接存取。
5. 配置模型：在設定中添加獨立的模型 API Key，先設定低額度及消費告警。
6. 載入倉庫：從乾淨的分支開始，確認 Git 狀態並備份重要改動。
7. 提交小任務：提供驗收條件、相關文件和測試命令，先觀察 Agent 的計劃和執行範圍。
8. 人工審查：查看差異、運行完整測試、安全掃描和建構流程，再決定是否提交或合併。

OpenHands Cloud使用流程

1. 註冊 Cloud Individual 賬號並連接需要使用的 Git 提供商。
2. 選擇自帶模型密鑰，或購買少量 credits 使用 OpenHands 模型提供層。
3. 僅授權目標倉庫，設定提交身份和必要的環境變數。
4. 建立會話，說明任務範圍、預期行為、測試方法以及禁止修改的區域。
5. 檢查終端輸出、檔案差異和測試結果；不要僅依據 Agent 的完成說明。
6. 確認改動安全後再創建提交或拉取請求，並由代碼所有者複核。

模型怎麼選

編程 Agent 對工具調用、長上下文、錯誤恢復以及指令遵循有較高要求，低價模型未必能降低總成本：如果反覆失敗或產生大量無效 token，最終費用可能更高。小型格式化、文件處理及簡單的測試任務則可考慮使用經濟型模型；

跨文件重構、複雜調試和架構分析更適合能力較強的模型。

本地模型可以減少外部資料傳輸，但需要足夠的顯存、推理速度以及相容的介面。使用前應先在非敏感環境中評估任務的成功率、運行時間、上下文長度以及總成本，不能只比較每百萬個 token 的單價。

安全注意事項

• Agent可以運行命令和修改檔案，應始終使用沙箱、虛擬機或權限受限帳號；
• 只掛載目標倉庫，禁止訪問個人文件、SSH目錄、雲端憑證及生產資料庫；
• 本地服務綁定迴環地址，對外開放時增強API金鑰、認證和網路訪問控制；
• 倉庫內容、Issue和網頁都可能包含提示注入，外部輸入應按不可信數據處理；
• 密鑰放入安全配置，避免出現在提示詞、日誌、提交和截圖中；
• 高風險操作採用人工批准，禁止Agent自動部署生產環境或合併主分支。

適合哪些用戶

• 希望讓 AI 實際修改、運行和測試代碼的開發者；
• 需要自動處理 Issue、依賴更新及代碼維護的開源團隊；
• 想基於開源 SDK 构建專用軟體開發智能體的研究者；
• 需要私有VPC、權限治理和大型規模並發的企業研發組織；
• 願意審查 Agent 行為並具備 Git、容器和安全基礎的工程人員。

優勢與使用限制

• OpenHands的優勢在於開源、與模型無關、可本地部署，並提供從互動介面到SDK及企業雲的完整解決方案；
• 它能讀取真實倉庫並透過執行回饋修正代碼，比只給建議的聊天工具更適合端到端開發任務；
• 限制是自主執行帶來更高權限和費用風險，任務耗時與效果強烈依賴模型、倉庫結構和測試品質；
• 本地部署需要容器與安全配置，雲端免費帳號有會話限制；
• AI生成的代碼可能引入漏洞、許可證問題及隱藏的回歸問題，不能跳過人工代碼審查；

常見問題

OpenHands免費嗎

核心開源版和 Cloud Individual 平台層均免費，但模型 API、Cloud credits、本地伺服器或 GPU 可能會產生費用。Enterprise 版則需另行報價。

OpenHands是開源的嗎

核心的 OpenHands 專案採用 MIT 授權條款。而企業自行托管的雲端組件則屬於 source-available 类型，若要長期使用則需要商業授權，這兩者必須區分開來。

OpenHands支援本地模型嗎

支援連接相容的本機模型服務，但 Agent 任務的要求較高，需要足夠的硬體以及經過驗證的工具呼叫能力。

OpenHands會直接修改代碼嗎

可以。它可編輯掛載目錄中的檔案並執行命令，因此應在獨立分支和沙箱中運行，完成後檢查所有差異與測試。

OpenHands和普通AI代碼補全有什麼區別

普通補全主要在編輯器中預測代碼；OpenHands可以規劃多步驟任務、操作倉庫、運行終端和測試，更接近可執行的軟體開發 Agent。