WindowsのコマンドプロンプトからOpenHandsを起動する

はじめに

Windows 11 Homeのコマンド プロンプトから、OpenHandsを起動・停止します。

Running OpenHands

コマンド プロンプトでの起動例

準備

Windows 11 HomeにWSL2とDocker Desktopをインストールします。

WSL2

Docker Desktop

コマンド プロンプトを開き、dockerイメージを取得します。

• docker.all-hands.dev/all-hands-ai/runtime:0.26-nikolaik

dockerコマンド

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

起動

コマンド プロンプトを開き、次のdockerコマンドでOpenHandsを起動し、ウェブブラウザで、 http://localhost:3000 へアクセスします。

dockerコマンド

docker run -it --rm --pull=always ^
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.26-nikolaik ^
    -e LOG_ALL_EVENTS=true ^
    -v //var/run/docker.sock:/var/run/docker.sock ^
    -v %USERPROFILE%/.openhands-state:/root/.openhands-state ^
    -p 3000:3000 ^
    --add-host host.docker.internal:host-gateway ^
    --name openhands-app ^
    docker.all-hands.dev/all-hands-ai/openhands:0.26

オリジナルのコマンドとの違い

Windowsのコマンド プロンプトで実行できるように、オリジナルのコマンドの一部を変更しています。

変更点1: 改行をコマンドの続きとするための \ を ^ に変更しています。

変更点2: docker.sockのボリュームを wsl のファイルとしています( / を追加)。

変更点3: ホームディレクトリの参照方法（~）を環境変数を使った方法（%USERPROFILE%）に変更しています。

オリジナル

docker run -it --rm --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.26-nikolaik \
    -e LOG_ALL_EVENTS=true \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v ~/.openhands-state:/.openhands-state \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app \
    docker.all-hands.dev/all-hands-ai/openhands:0.26

ウェブブラウザでの初期表示
http://localhost:3000

停止

起動したコマンドプロンプトで、CTRL + Cを押下すると停止します。

コマンド プロンプトを閉じてしまった場合

Docker Desktop Dashboardを開き、Containersに表示されたopnehands-appのActionsボタンで停止(Stop)することができます。

おわりに

公式のRunning OpenHandsに従って、Windows 11 Homeの コマンド プロンプトからOpenHandsを起動しました。

コマンドの書き方には、次の３つのポイントがありました。

1. 改行をコマンドの続きとするための \ を ^ に変更しました
2. docker.sockのボリュームを wsl のファイルとしました(/を追加)
3. ホームディレクトリの参照方法（~）を環境変数を使った方法（%USERPROFILE%）に変更しました