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_searchは Valkey Search モジュールを公式の非同期クライアントvalkey-glide経由で利用し、ベクター検索・全文検索・ハイブリッド検索の 3 モードに対応します。モジュールを読み込んだサーバー(例:valkey/valkey-bundle:9.1.0、docker 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__PORT は api.port を表します。
API__PORTはapi.portを表しますCONCURRENCY__PIPELINEはconcurrency.pipelineを表しますDATABASE__SQLITE__PATHはdatabase.sqlite.pathを表しますSTORAGE__CLEANUP__UPLOADED_FILE_RETENTION_DAYSはstorage.cleanup.uploaded_file_retention_daysを表しますSTORAGE__CLEANUP__LOG_RETENTION_DAYSはstorage.cleanup.log_retention_daysを表しますMONITORING__AUTO_CLEANUP__RETENTION_DAYSはmonitoring.auto_cleanup.retention_daysを表しますPLUGIN__BINARY_STORAGE__MAX_VALUE_BYTESはplugin.binary_storage.max_value_bytesを表しますBOX__BACKENDはbox.backendを表しますBOX__LOCAL__HOST_ROOTはbox.local.host_rootを表しますBOX__LOCAL__SKILLS_ROOTはbox.local.skills_rootを表します
config.yaml に適用して data/config.yaml ファイルに書き込みます。
Box 関連設定は
langbot サービスに統一形式の BOX__* 環境変数で設定します。LangBot は起動時にそれらを data/config.yaml に適用し、INIT RPC 経由で Box 設定を langbot_box に渡します。LANGBOT_BOX_* や BOX__* を langbot_box に設定しても直接読み取られません。