OpenHands AI 軟體開發代理

Mon, 02 Mar 2026 00:00:00 +0000

專案簡介

OpenHands（前身為 OpenDevin）是一個開源的 AI 軟體開發代理平台。它能讓 AI 像人類開發者一樣操作電腦，執行程式撰寫、終端機指令、網頁瀏覽等任務。

GitHub Stars: 67K+

主要功能

自主開發 - AI 自動完成程式撰寫任務
終端操作 - 執行 shell 指令和腳本
瀏覽器操作 - 網頁搜尋和資料收集
檔案編輯 - 讀寫程式碼檔案
多模型支援 - Claude、GPT-4、本地模型

快速開始

Docker 部署

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


docker pull docker.all-hands.dev/all-hands-ai/runtime:0.21-nikolaik

docker run -it --rm \
 -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.21-nikolaik \
 -e LOG_ALL_EVENTS=true \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v ~/.openhands:/root/.openhands \
 -p 3000:3000 \
 --name openhands \
 docker.all-hands.dev/all-hands-ai/openhands:0.21

訪問 http://localhost:3000

設定 LLM

開啟設定頁面
選擇 LLM Provider（Anthropic、OpenAI、Ollama）
輸入 API Key
選擇模型

使用方式

基本對話

1
2
3
4
5
6
7
8


User: 幫我建立一個 Python FastAPI 專案，包含使用者認證功能

OpenHands:
1. 建立專案結構
2. 安裝依賴套件
3. 撰寫認證邏輯
4. 建立 API 端點
5. 新增測試

程式碼修改

1
2
3
4
5
6
7


User: 修復 src/auth.py 中的 SQL Injection 漏洞

OpenHands:
1. 讀取檔案內容
2. 識別漏洞位置
3. 使用參數化查詢修復
4. 驗證修改結果

除錯任務

1
2
3
4
5
6
7
8


User: 這個 Python 腳本執行時報錯，請幫我修復
[貼上錯誤訊息]

OpenHands:
1. 分析錯誤訊息
2. 檢查相關程式碼
3. 找出問題根因
4. 提供修復方案並執行

進階設定

自訂工作空間

1
2
3
4


docker run -it --rm \
 -v /path/to/your/project:/opt/workspace \
 -e WORKSPACE_MOUNT_PATH=/opt/workspace \
 ...

使用本地模型

1
2
3


# 使用 Ollama
-e LLM_MODEL=ollama/llama3.3
-e LLM_BASE_URL=http://host.docker.internal:11434

環境變數

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# LLM 設定
LLM_MODEL=anthropic/claude-3-5-sonnet-20241022
LLM_API_KEY=your-api-key

# 沙盒設定
SANDBOX_USER_ID=1000
SANDBOX_TIMEOUT=300

# 日誌
LOG_ALL_EVENTS=true
DEBUG=true

Agent 能力

可執行的動作

動作	說明
`run`	執行 shell 指令
`read`	讀取檔案
`write`	寫入檔案
`browse`	瀏覽網頁
`think`	規劃下一步
`finish`	完成任務

範例工作流程

1
2
3
4
5
6
7


# OpenHands 內部執行流程
1. Think: 分析使用者需求
2. Run: pip install fastapi uvicorn
3. Write: 建立 main.py
4. Write: 建立 requirements.txt
5. Run: python -m pytest tests/
6. Finish: 任務完成

安全考量

沙盒隔離

OpenHands 在 Docker 容器中執行，與主機系統隔離：

1
2
3
4
5
6


# 限制網路存取
--network none

# 限制資源
--memory=4g
--cpus=2

權限控制

1
2
3
4
5


# 唯讀掛載
-v /path/to/code:/workspace:ro

# 非 root 使用者
-e SANDBOX_USER_ID=1000

整合開發流程

GitHub 整合

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# .github/workflows/openhands.yml
name: AI Code Review
on: [pull_request]
jobs:
 review:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v4
 - name: Run OpenHands Review
 run: |
 # 呼叫 OpenHands API 進行程式碼審查

VS Code 整合

透過 API 與編輯器整合：

1
2
3
4
5
6


import requests

response = requests.post(
 'http://localhost:3000/api/chat',
 json={'message': '解釋這段程式碼'}
)

coding on Astroicers Blog