Skip to main content
システム動作のための環境情報を設定します。設定ファイルは data/config.yaml にあります。 通常、変更は必要ありません。

補足

  • storage.cleanup.uploaded_file_retention_days はストレージルート直下の一時アップロードファイルのみを削除します。プラグイン設定ファイルやディレクトリ配下の内部オブジェクトは削除しません。
  • storage.cleanup.log_retention_days はファイル名の日付に基づいて古いログを削除します。デフォルトでは最大 3 日分のログを保持します。
  • SQLite をデータベースとして使用している場合、監視レコードの自動削除後にデータベースファイルの空き容量を直接解放します。
  • plugin.binary_storage.max_value_bytes は 1 つのプラグインバイナリストレージ値のサイズを制限します。デフォルトは 10 MiB です。
  • WebUI のサイドバーには「ストレージ分析」ページがあり、データベース、ログ、アップロードファイル、ベクターストア、プラグイン、MCP、一時ファイル、クリーンアップ候補を確認できます。
  • vdb.valkey_searchValkey Search モジュールを公式の非同期クライアント valkey-glide 経由で利用し、ベクター検索・全文検索・ハイブリッド検索の 3 モードに対応します。モジュールを読み込んだサーバー(例: valkey/valkey-bundle:9.1.0docker run -d -p 6379:6379 valkey/valkey-bundle:9.1.0)を起動してください。注意: ハイブリッド検索はフィルタ後に KNN を行うモデルのため、vector_weight パラメータは受け付けられますが反映されません(Valkey Search の原生的な制限)。接続は遅延確立されるため、サーバーが停止・誤設定でも起動を妨げません。詳細は Valkey Search 統合ドキュメント を参照してください。
  • api.global_api_key はエージェント / 自動化向けのグローバル API キーです。設定すると、HTTP API または組み込み MCP サーバー(/mcp)の呼び出し時に X-API-Key: <key> または Authorization: Bearer *** を送るだけで認証されます(ログインセッションやデータベース保存の lbk_ キーは不要)。config.yaml` に平文で保存されるため、信頼できる / 内部デプロイでのみ有効化し、HTTPS で公開してください。API キー認証 を参照。

環境変数による設定

config.yaml の設定は環境変数を介して設定できます。環境変数名は大文字で、二重アンダースコアで接続されます。例: API__PORTapi.port を表します。
  • API__PORTapi.port を表します
  • CONCURRENCY__PIPELINEconcurrency.pipeline を表します
  • DATABASE__SQLITE__PATHdatabase.sqlite.path を表します
  • STORAGE__CLEANUP__UPLOADED_FILE_RETENTION_DAYSstorage.cleanup.uploaded_file_retention_days を表します
  • STORAGE__CLEANUP__LOG_RETENTION_DAYSstorage.cleanup.log_retention_days を表します
  • MONITORING__AUTO_CLEANUP__RETENTION_DAYSmonitoring.auto_cleanup.retention_days を表します
  • PLUGIN__BINARY_STORAGE__MAX_VALUE_BYTESplugin.binary_storage.max_value_bytes を表します
  • BOX__BACKENDbox.backend を表します
  • BOX__LOCAL__HOST_ROOTbox.local.host_root を表します
  • BOX__LOCAL__SKILLS_ROOTbox.local.skills_root を表します
起動時、LangBot はすべての環境変数を読み取り、対応する設定を config.yaml に適用して data/config.yaml ファイルに書き込みます。
Box 関連設定は langbot サービスに統一形式の BOX__* 環境変数で設定します。LangBot は起動時にそれらを data/config.yaml に適用し、INIT RPC 経由で Box 設定を langbot_box に渡します。LANGBOT_BOX_*BOX__*langbot_box に設定しても直接読み取られません。