OpenClaw devbox 🦞

OpenClaw メインアプリケーションの拡張ノード。プログラミング言語と開発ツールがプリインストールされたリモート実行環境を提供します。

プリインストール済み言語・ツール

• Python 3（python3、pip、venv）
• Node.js（OpenClaw ベースイメージに含まれます）
• Go（golang）
• Rust（rustc、cargo）
• C/C++（gcc、g++、make、cmake）
• 開発ツール：git、curl、wget、jq、unzip、zip

パッケージの永続化

ユーザーがインストールしたパッケージはコンテナの再起動後も保持されます：

• pip install → ~/.local/
• npm install -g → ~/.npm-global/
• go install → ~/go/
• cargo install → ~/.cargo/

Git 認証（オプション）

プライベートリポジトリをクローンするには、Zeabur ダッシュボードの devbox サービスに以下の環境変数を追加してください：

• GIT_TOKEN — GitHub personal access token。起動スクリプトが自動的に HTTPS 認証を設定します。GitHub > Settings > Developer settings > Personal access tokens で repo スコープを有効にして生成してください。
• SSH_PRIVATE_KEY — Base64 エンコードされた SSH 秘密鍵。起動スクリプトが自動的に ~/.ssh/id_rsa に書き込みます。 鍵ペアの生成とエンコード：

  ssh-keygen -t ed25519 -f ~/.ssh/openclaw_devbox -N ""
  base64 -i ~/.ssh/openclaw_devbox    # この値を SSH_PRIVATE_KEY に貼り付け
  

  ~/.ssh/openclaw_devbox.pub を GitHub アカウントの Settings > SSH and GPG keys に追加してください。

ユースケース

• 多言語コード実行 — 会話で AI に Python、Go、Rust、C のコードを書いて実行してもらう
• パッケージのインストールとテスト — AI にサードパーティパッケージをインストールして機能を検証してもらう（インストールは再起動後も保持）
• データ処理と分析 — データファイルをアップロードし、AI に Python や jq で処理・変換・分析してもらう
• Git 操作とプロジェクトビルド — リポジトリのクローン、プロジェクトのビルド、テストの実行
• システム自動化スクリプト — シェルスクリプトや自動化ツールの作成とテスト

前提条件

まず OpenClaw インスタンスが稼働している必要があります。まだお持ちでない場合は、先に OpenClaw メインアプリケーションテンプレート をデプロイしてください。

セットアップ

1. デプロイ前に、OpenClaw サービスの指示タブから Gateway Token をコピーしておくと、入力がスムーズです
2. このテンプレートを OpenClaw インスタンスと同じ Zeabur プロジェクトにデプロイします
3. Gateway Token と Gateway Host（OpenClaw インスタンスの Zeabur サービス名、例えばサービス名が openclaw の場合は openclaw と入力）を入力します
4. devbox ノードが OpenClaw に接続し、ペアリングリクエストを送信します
5. OpenClaw サービスターミナルでペアリングリクエストを承認します：

   openclaw devices list       # 保留中のリクエスト ID を確認
   openclaw devices approve <requestId>
   

推奨リソース

• CPU：2 vCPU
• メモリ：2048 MB

確認

デプロイ後、devbox ノードが OpenClaw に表示されていることを確認します：

• OpenClaw サービスターミナルで openclaw nodes list を実行
• または OpenClaw Web UI のノードページで確認
• または会話で直接聞く：「devbox の node は見えますか？」

アーキテクチャ

• 公開ポートなし — devbox は WebSocket で OpenClaw gateway に発信接続します
• exec.security は full に設定 — コマンド実行時にインタラクティブな承認は不要
• システムランタイムはイメージに組み込み済み；ユーザーパッケージは永続ボリュームに保存

トラブルシューティング

• Gateway Host を入力しても openclaw devices list にペアリングリクエストが表示されない場合、サービス名が正しくない可能性があります。Zeabur ダッシュボードで OpenClaw サービスのネットワークタブを開き、プライベートホスト名を確認してください。例えばプライベートホスト名が openclaw.zeabur.internal の場合、Gateway Host には openclaw（.zeabur.internal の前の部分）を入力してください。
• devbox サービスが長時間ペアリングに成功しない場合、Zeabur が自動的にサービスを一時停止することがあります。ペアリングを試みる前に、devbox サービスが実行中であることを確認してください。