mirror of https://github.com/OpenHands/OpenHands.git synced 2025-12-26 05:48:36 +08:00

Co-authored-by: Ray Myers <ray.myers@gmail.com>
Co-authored-by: openhands <openhands@all-hands.dev>
Co-authored-by: Chuck Butkus <chuck@all-hands.dev>

2025-04-29 17:45:40 -04:00

2.6 KiB

Raw Blame History

ヘッドレスモード

OpenHandsは、Webアプリケーションを起動せずに、単一のコマンドで実行できます。これにより、OpenHandsを使用してスクリプトを作成したり、タスクを自動化したりするのが簡単になります。

これは、インタラクティブで、アクティブな開発に適したCLIモードとは異なります。

Pythonを使用する場合

PythonでOpenHandsをヘッドレスモードで実行するには:

開発セットアップの手順に従っていることを確認してください。
以下のコマンドを実行します:

poetry run python -m openhands.core.main -t "write a bash script that prints hi"

モデル、APIキー、その他の設定は、環境変数またはconfig.tomlファイルを介して設定する必要があります。

Dockerを使用する場合

DockerでOpenHandsをヘッドレスモードで実行するには:

ターミナルで以下の環境変数を設定します:

WORKSPACE_BASEをOpenHandsが編集するディレクトリに設定 (例: export WORKSPACE_BASE=$(pwd)/workspace)。
LLM_MODELを使用するモデルに設定 (例: export LLM_MODEL="anthropic/claude-3-5-sonnet-20241022")。
LLM_API_KEYをAPIキーに設定 (例: export LLM_API_KEY="sk_test_12345")。

以下のDockerコマンドを実行します:

docker run -it \
    --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.35-nikolaik \
    -e SANDBOX_USER_ID=$(id -u) \
    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
    -e LLM_API_KEY=$LLM_API_KEY \
    -e LLM_MODEL=$LLM_MODEL \
    -e LOG_ALL_EVENTS=true \
    -v $WORKSPACE_BASE:/opt/workspace_base \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v ~/.openhands-state:/.openhands-state \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app-$(date +%Y%m%d%H%M%S) \
    docker.all-hands.dev/all-hands-ai/openhands:0.35 \
    python -m openhands.core.main -t "write a bash script that prints hi"

高度なヘッドレス設定

ヘッドレスモードで利用可能なすべての設定オプションを表示するには、--helpフラグを付けてPythonコマンドを実行します。

追加のログ

ヘッドレスモードでエージェントのすべてのアクションをログに記録するには、ターミナルでexport LOG_ALL_EVENTS=trueを実行します。

2.6 KiB Raw Blame History