OpenHands：超強 AI 程式開發助手完整攻略

1
# 下載最新版本
2
docker pull ghcr.io/all-hands-ai/openhands:main
3

4
# 執行 OpenHands
5
docker run -it --rm \
6
  -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.8-nikolaik \
7
  -e WORKSPACE_MOUNT_PATH=$PWD \
8
  -v /var/run/docker.sock:/var/run/docker.sock \
9
  -v $PWD:/opt/workspace_base \
10
  -p 3000:3000 \
11
  --add-host host.docker.internal:host-gateway \
12
  --name openhands-app-$(date +%Y%m%d%H%M%S) \
13
  ghcr.io/all-hands-ai/openhands:main

方法二：從原始碼安裝#

1
# 複製專案
2
git clone https://github.com/All-Hands-AI/OpenHands.git
3
cd OpenHands
4

5
# 安裝套件
6
pip install -e .
7

8
# 啟動程式
9
python -m openhands.core.main

設定 API 金鑰#

OpenHands 支援多種 LLM 服務商：

1
# OpenAI
2
export OPENAI_API_KEY="your-api-key"
3

4
# Anthropic Claude
5
export ANTHROPIC_API_KEY="your-api-key"
6

7
# Google Gemini
8
export GOOGLE_API_KEY="your-api-key"
9

10
# 本地模型（Ollama）
11
export OLLAMA_BASE_URL="http://localhost:11434"

API 金鑰安全性
建議把 API 金鑰放在 .env 檔案裡，並加到 .gitignore 避免不小心 commit 上去。

實際使用案例#

案例一：建立 FastAPI 專案#

來看看怎麼用 OpenHands 快速建立一個 FastAPI 專案：

1
請幫我建立一個 FastAPI 專案，要包含：
2
1. 使用者註冊和登入功能
3
2. JWT 驗證
4
3. SQLite 資料庫
5
4. 基本的 CRUD 操作
6
5. API 文件

OpenHands 會自動幫你：

建立專案架構
安裝需要的套件
寫程式碼
設定資料庫
產生 API 文件
跑測試

案例二：Debug 現有專案#

遇到複雜的 bug 時：

1
我的 React App 在正式環境會有記憶體洩漏的問題，
2
請幫我分析並修復。

OpenHands 會：

分析程式碼找出可能的問題
檢查記憶體使用狀況
找出沒有清理的事件監聽器或計時器
提供修復方案並實作
驗證修復結果

案例三：自動化部署#

1
請幫我設定 CI/CD 流程，把我的 Node.js App
2
自動部署到 Vercel，要包含測試和程式碼品質檢查。

進階功能#

🔄 工作流程自動化#

OpenHands 可以處理複雜的多步驟任務：

1
# 範例：自動化程式碼審查流程
2
workflow = {
3
    "steps": [
4
        "分析程式碼品質",
5
        "執行單元測試",
6
        "檢查安全性漏洞",
7
        "產生審查報告",
8
        "提出改善建議"
9
    ]
10
}

🧠 學習與適應#

智慧學習
OpenHands 會從每次互動中學習，慢慢適應你的程式開發風格和習慣。

🔌 外掛系統#

支援自訂外掛來擴充功能：

1
# 自訂外掛範例
2
class CustomPlugin:
3
    def __init__(self):
4
        self.name = "custom_analyzer"
5

6
    def analyze_code(self, code):
7
        # 自訂分析邏輯
8
        return analysis_result

使用技巧#

📋 有效的提示方法#

要具體明確

1
❌ 幫我修這個 bug
2
✅ 我的 Python Flask App 在處理大檔案上傳時會逾時，
3
   請分析並修復這個問題，還要加上進度顯示功能

提供背景資訊

1
✅ 這是一個電商網站的購物車功能，用 React + Redux 做的，
2
   需要加上折價券計算邏輯

分步驟說明

1
✅ 請照以下步驟進行：
2
1. 先分析現有的資料結構
3
2. 設計折價券計算演算法
4
3. 實作前端介面
5
4. 加上單元測試

🔒 安全性考量#

安全提醒

不要在提示裡放敏感資料（密碼、API 金鑰等）

定期檢查產生的程式碼有沒有安全性問題

在正式環境使用前一定要充分測試

📊 效能調校#

1
# 監控資源使用狀況
2
docker stats openhands-app
3

4
# 調整記憶體限制
5
docker run --memory=4g --cpus=2 ...

與其他工具比較#

特色	OpenHands	GitHub Copilot	Cursor	Replit Agent
開源	✅	❌	❌	❌
自主執行	✅	❌	部分	✅
多語言支援	✅	✅	✅	✅
本地部署	✅	❌	❌	❌
自訂模型	✅	❌	❌	❌

社群與生態#

🌟 活躍的開源社群#

GitHub Stars: 30k+
貢獻者: 500+
每月活躍使用者: 10k+

📚 學習資源#

未來發展#

🚀 即將推出的功能#

開發藍圖

視覺化程式開發介面

更多 IDE 整合

增強的多模態能力

企業級功能

🔮 長期目標#

OpenHands 的目標是成為：

最聰明的程式開發助手
開發者的最佳夥伴
程式教育的創新工具

總結#

OpenHands 代表了 AI 輔助程式開發的未來。它不只是一個工具，更是一個能夠理解、學習和執行的智慧夥伴。不管你是新手還是資深工程師，OpenHands 都能大幅提升你的開發效率和程式碼品質。

馬上開始
趕快試試 OpenHands，體驗 AI 驅動的程式開發革命！

本文章由 OpenHands 協助撰寫。