OpenHandsの実行
システム要件
- Docker バージョン26.0.0+またはDocker Desktop 4.31.0+
- LinuxまたはMac OSを使用する必要があります
- Windowsを使用している場合は、WSLを使用する必要があります
アプリケーションの起動
OpenHandsを実行する最も簡単な方法は、Dockerを使用することです。
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.29-nikolaik
docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.29-nikolaik \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.all-hands.dev/all-hands-ai/openhands:0.29
また、ヘッドレススクリプトモード、対話型CLI、またはOpenHands GitHub Actionとしても実行できます。
設定
上記のコマンドを実行すると、OpenHandsはhttp://localhost:3000で動作します。
OpenHandsを起動すると、設定モーダルウィンドウが表示されます。LLMプロバイダー
とLLMモデル
を選択し、対応するAPIキー
を入力する必要があります。
これらの設定は、UIの設定
ボタン(歯車アイコン)を選択することでいつでも変更できます。
必要なLLMモデル
がリストに存在しない場合は、詳細オプション
を有効にして、
カスタムモデル
テキストボックスに適切なプレフィックスを付けて手動で入力できます。
詳細オプション
では、必要に応じてベースURL
も指定できます。


バージョン
上記のコマンドは、OpenHandsの最新の安定版を取得します。他のオプションもあります:
- 特定のバージョンを使用する場合は、
docker.all-hands.dev/all-hands-ai/openhands:$VERSION
を使用し、$VERSIONをバージョン番号に置き換えてください。 - semverを使用しており、メジャー、マイナー、パッチバージョンのタグを公開しています。したがって、
0.9
は最新の0.9.x
バージョンを、0
は最新の0.x.x
バージョンを指します。 - 最新の開発バージョンを使用する場合は、
docker.all-hands.dev/all-hands-ai/openhands:main
を使用できます。このバージョンは不安定で、テストまたは開発目的でのみ推奨されます。
安定性要件と必要な機能に応じて、最適なタグを選択できます。
開発ワークフローについては、Development.mdを参照してください。
問題がありますか?トラブルシューティングガイドをご確認ください。