Configuration

This page is the canonical configuration entrypoint for jhf-bobbin.

Primary Truth Sources

• configs/installer.env.example
• configs/stack-contract.json
• configs/oss-inventory.json
• STACK_CONTAINER_CONTRACT.md (docs/STACK_CONTAINER_CONTRACT.md)

Key Configuration Domains

Installer and runtime mode:

• OPENCLAW_MODE
• OPENCLAW_SERVICE_NAME
• RUN_AS_ROOT
• OPENCLAW_CONFIG_DIR
• OPENCLAW_CONFIG_FILE
• OPENCLAW_ENV_FILE

Memory/runtime endpoints:

• LOCALAI_BASE_URL
• LOCALAI_PROFILE
• LOCALAI_PORT
• QDRANT_URL
• QDRANT_API_KEY
• USE_LOCAL_QDRANT

QDRANT_API_KEY is optional and is consumed by the repo-owned Qdrant maintenance scripts when the target Qdrant runtime requires authenticated HTTP requests via the documented api-key header.

Mem0 behavior:

• MEM0_USER_ID
• MEM0_LLM_PROVIDER
• MEM0_LLM_MODEL
• MEM0_LLM_BASE_URL
• MEM0_AGENT_ACCESS_DEFAULT
• MEM0_AGENT_ACCESS_RULES

Plugin source and patch targets:

• PLUGIN_REPO_URL
• PLUGIN_REPO_REF
• PLUGIN_TARGET_NAME
• PLUGIN_OVERRIDE_DIR
• PLUGIN_INDEX_OVERRIDE_FILE
• PLUGIN_VENDOR_FILE

Relative plugin override paths are resolved from the repository root. The install and reapply scripts must use these variables instead of hardcoded patch target paths.

Guardrails:

• LOCALAI_PROBE_DEGRADE_THRESHOLD
• LOCALAI_PROBE_TIMEOUT_WINDOW_SECONDS
• LOCALAI_PROBE_DEGRADE_COOLDOWN_SECONDS
• LOCALAI_MODELS_MIN_INTERVAL_SECONDS

Configuration Rule

Bobbin must not create a local shadow truth for Fabric-owned policy, lifecycle, or readiness semantics. Repo-owned configuration stops at installer/runtime materialization and bounded verification behavior.

Verify Configuration

python3 scripts/check_stack_contract.py
python3 scripts/check_runtime_materialization_drift.py
python3 scripts/check_runtime_version_truth.py
python3 scripts/check_oss_inventory_contract.py
python3 scripts/check_installer_configurability_contract.py

AGPLv3. See ../LICENSE (LICENSE).

Learn more at helpifyr.com.