メインコンテンツへスキップ
サンドボックス設定は LangBot メインプロセスが管理し、Box Runtime が実際の実行を担当します。通常のデプロイでは、バックエンド、ワークスペースディレクトリ、セキュリティプロファイルだけを決めれば十分です。
このページの box.* 設定はすべて data/config.yaml に記述します。ファイルの場所と読み込みの仕組みはシステム環境設定を参照してください。

​
推奨設定

box:
  enabled: true
  backend: 'local'        # Docker / Nsjail から利用可能なものを自動選択
  local:
    profile: 'default'
    host_root: './data/box'
    skills_root: 'skills'
  • enabled：サンドボックスのマスタースイッチ。false にすると、サンドボックス組み込みツール、Skill の追加 / 編集、stdio MCP のホスティングなど Box 依存の機能はすべて無効になります。
  • backend：下記「バックエンドの選択」を参照。
  • local.profile：セキュリティプロファイル。ネットワーク、マウント、リソース制限を制御。
  • local.host_root：ホスト側のサンドボックス作業ディレクトリ。サンドボックス内では /workspace にマウントされます。
  • local.skills_root：Skill パッケージのディレクトリ。相対パスは host_root 配下に解決され、デフォルトは host_root/skills。
Skill は Box Runtime が管理する skill store からのみ読み込まれます。Box Runtime またはバックエンドが利用できない場合、Skill 一覧は空になり、追加 / 編集 / register_skill も使えません。data/skills/ へのフォールバックは行いません。

​
バックエンドの選択

サンドボックスはローカルコンテナまたはクラウドで動作させられます。box.backend でどちらを使うかを指定します：
backend実行場所動作
local（既定）ローカルコンテナDocker / Nsjail から利用可能なものを自動選択（Docker 優先）
dockerローカルコンテナDocker を強制使用。Docker daemon が必要
nsjailローカルコンテナNsjail を強制使用（Linux のみ）。カスタムイメージ非対応
e2bクラウドE2B クラウドサンドボックスを使用。API キーが必要
local は「自動選択」のショートハンドであり、docker / nsjail と並列の 4 つ目のバックエンドではありません。ローカル系バックエンド（local / docker / nsjail）は box.local.* 設定セクションを共有し、クラウドバックエンドは box.e2b.* を使います。
backend は強制値です。docker を指定して Docker が使えない場合、Nsjail や E2B に自動でフォールバックしません。自動 fan-out するのは local だけです。環境変数 BOX__BACKEND で box.backend を上書きできます（config.yaml より優先）。

​
セキュリティプロファイル

box.local.profile はローカル系バックエンドのネットワーク、マウント、リソース制限を制御します：
Profileネットワークマウントリソース推奨シーン
defaultオフ読み書き既定制限既定の選択
offline_readonlyオフ読み取り専用より厳格信頼できないファイルの読み込み
network_basic基本ネットワーク読み書き既定制限API アクセス、依存関係インストール
network_extendedフルネットワーク読み書き緩和開発、デバッグ、複雑なタスク
最小権限を優先：ネットワークが不要なら default または offline_readonly；allowed_mount_roots には必要なディレクトリのみを追加。

​
ローカル系バックエンド設定（box.local.*）

ローカル系バックエンド（local / docker / nsjail）は以下を共有します：
設定項目既定値説明
local.profiledefault上記「セキュリティプロファイル」を参照
local.image空Docker バックエンドのカスタムイメージ。空 = プロファイル既定を使用
local.host_root./data/boxホスト作業ディレクトリのベース。サンドボックス内の /workspace にマップ
local.default_workspace空既定ワークスペース名。空 = <host_root>/default
local.skills_rootskillsSkill パッケージディレクトリ。相対パスは host_root 配下に解決
local.allowed_mount_roots[host_root]Agent がマウント要求できるホストディレクトリの許可リスト
local.workspace_quota_mbnullワークスペースのディスク配額（MB）。null = プロファイル既定

​
クラウドバックエンド設定（box.e2b.*）

backend: 'e2b' を指定したうえで設定します：
設定項目既定値説明
e2b.api_key空E2B API キー。環境変数 E2B_API_KEY でも設定可
e2b.api_url空セルフホスト E2B のエンドポイント。環境変数 E2B_API_URL でも設定可
e2b.template空既定の E2B テンプレート ID
E2B はホスト側に Docker や Nsjail を必要とせず、毎回の実行をリモートサンドボックスで行います。

​
Docker Compose デプロイ

Docker Compose では、サンドボックス設定は langbot サービス側に記述します。LangBot は起動時に INIT RPC で設定を langbot_box に転送します。 
services:
  langbot_box:
    image: rockchin/langbot:latest
    container_name: langbot_box
    profiles: ["box", "all"]
    volumes:
      - ${LANGBOT_BOX_ROOT:-${PWD}/data/box}:${LANGBOT_BOX_ROOT:-${PWD}/data/box}
      - /var/run/docker.sock:/var/run/docker.sock
    command: ["uv", "run", "--no-sync", "-m", "langbot_plugin.cli.__init__", "box"]

  langbot:
    image: rockchin/langbot:latest
    volumes:
      - ./data:/app/data
    environment:
      - BOX__LOCAL__HOST_ROOT=${LANGBOT_BOX_ROOT:-${PWD}/data/box}
      - BOX__LOCAL__SKILLS_ROOT=skills
      - BOX__LOCAL__ALLOWED_MOUNT_ROOTS=${LANGBOT_BOX_ROOT:-${PWD}/data/box}
langbot_box は Docker daemon にアクセスします。docker.sock のマウントは信頼できる環境でのみ行い、Box のルートパスをホストと langbot_box コンテナ内で一致させてください。
外部の Box Runtime（リモートホストなど）に接続する場合は box.runtime.endpoint で URL を指定します： 
box:
  runtime:
    endpoint: 'ws://192.168.1.10:5410'

​
環境変数

環境変数対応する設定
BOX__ENABLEDbox.enabled
BOX__BACKENDbox.backend
BOX__LOCAL__PROFILEbox.local.profile
BOX__LOCAL__IMAGEbox.local.image
BOX__LOCAL__HOST_ROOTbox.local.host_root
BOX__LOCAL__DEFAULT_WORKSPACEbox.local.default_workspace
BOX__LOCAL__SKILLS_ROOTbox.local.skills_root
BOX__LOCAL__ALLOWED_MOUNT_ROOTSbox.local.allowed_mount_roots、カンマ区切り
BOX__LOCAL__WORKSPACE_QUOTA_MBbox.local.workspace_quota_mb
BOX__E2B__API_KEYbox.e2b.api_key
BOX__E2B__API_URLbox.e2b.api_url
BOX__E2B__TEMPLATEbox.e2b.template
langbot_box サービス側には BOX__* や LANGBOT_BOX_* を設定しないでください。Box Runtime はこれらを直接読みません——設定は LangBot から INIT RPC 経由で渡されます。