Skip to main content

Configuration

Documentation Map​

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
  • RUN_AS_ROOT
  • OPENCLAW_CONFIG_DIR
  • OPENCLAW_CONFIG_FILE
  • OPENCLAW_ENV_FILE

Memory/runtime endpoints:

  • LOCALAI_BASE_URL
  • LOCALAI_PROFILE
  • LOCALAI_PORT
  • QDRANT_URL
  • USE_LOCAL_QDRANT

Mem0 behavior:

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

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

AGPLv3. See ../LICENSE (LICENSE).

Learn more at helpifyr.com.