Skip to main content

Quick Start

Documentation Index

This index is the canonical navigation page for jhf-openclaw-env documentation, categorized by doc class.

Canonical Docs​

Core documentation about what this repository is and how it works.

  • Overview
  • Operations
  • Security
  • Business Capabilities
  • Feature Registry (docs/MODULE_FEATURES.md)
  • Stack Runtime Contract (docs/STACK_RUNTIME_CONTRACT.md)
  • Autonomous Backlog (docs/AUTONOMOUS_BACKLOG.md)
  • Environment Baseline (docs/ENV_BASELINE.md)
  • Integrations
  • Stack OSS Runtime Materialization
  • Public vs Internal Content (docs/PUBLIC_VS_INTERNAL_CONTENT.md)
  • OSS SSO Status Matrix (docs/OSS_SSO_STATUS_MATRIX.md)
  • Web Surface Runtime Truth (docs/WEB_SURFACE_RUNTIME_TRUTH.md)
  • SSO HTTPS Surface Inventory (docs/SSO_HTTPS_SURFACE_INVENTORY.md)
  • ERP Identity Lifecycle Boundary (docs/ERP_IDENTITY_LIFECYCLE_BOUNDARY.md)
  • Helpifyr Agent Bootstrap Chain Runtime (docs/HELPIFYR_AGENT_BOOTSTRAP_CHAIN.md)
  • Jadda Auxiliary Ingress Runtime (docs/JADDA_INTERFACE_AUXILIARY_INGRESS_RUNTIME.md)

Contracts​

Formal runtime contracts defining behavior boundaries and verification gates.

  • Fabric Tool Profile (docs/FABRIC_TOOL_PROFILE.md)
  • ACP-W2 OpenClaw MCP Gateway Materialization (docs/ACP_W2_OPENCLAW_MCP_GATEWAY_MATERIALIZATION.md)
  • Fabric ACP Readback Runtime (docs/FABRIC_ACP_READBACK_RUNTIME.md)
  • Fabric S0 Model Catalog Readback Runtime (docs/FABRIC_S0_MODEL_CATALOG_READBACK_RUNTIME.md)
  • Deployment Consumer Boundary (docs/DEPLOYMENT_CONSUMER_BOUNDARY.md)
  • OpenClaw Runtime Version Floor (docs/OPENCLAW_RUNTIME_VERSION_FLOOR.md)
  • Advice V1 Dependency and Runtime Preflight (docs/ADVICE_V1_DEPENDENCY_RUNTIME_PREFLIGHT.md)
  • OpenClaw Warp Runtime Contract (docs/OPENCLAW_WARP_RUNTIME_CONTRACT.md)
  • Runtime Port Observation Policy (docs/RUNTIME_PORT_OBSERVATION_POLICY.md)
  • Runtime Projection Executor Contract (docs/RUNTIME_PROJECTION_EXECUTOR_CONTRACT.md)
  • Realtime Voice Upgrade v6 Warm Gateway Contract (docs/REALTIME_VOICE_UPGRADE_V6_WARM_GATEWAY_CONTRACT.md)
  • Helpifyr OpenClaw Environment DNS Contract (docs/contracts/HELPIFYR_OPENCLAW_ENV_DNS_CONTRACT.md)

Operational Docs​

Operational governance, configuration, and runtime procedures.

  • Autonomous Restart Guardrail (docs/AUTONOMOUS_RESTART_GUARDRAIL.md)
  • Deployment Verify and Drift (docs/DEPLOYMENT_VERIFY_AND_DRIFT.md)
  • External Blocker Routing (docs/EXTERNAL_BLOCKER_ROUTING.md)
  • Helpifyr Stack Switches (docs/HELPIFYR_STACK_SWITCHES.md)
  • Host Docker Log Guardrails (docs/HOST_DOCKER_LOG_GUARDRAILS.md)
  • Keystore SSO Bootstrap Prerequisites (docs/KEYSTORE_SSO_BOOTSTRAP_PREREQS.md)
  • OpenClaw Warm Voice Gateway Runtime (docs/OPENCLAW_WARM_VOICE_GATEWAY_RUNTIME.md)
  • Secrets and Environment Policy (docs/SECRETS_AND_ENV_POLICY.md)
  • SSO HTTPS Surface Inventory (docs/SSO_HTTPS_SURFACE_INVENTORY.md)
  • SSO-v4 Env Auth Runtime (docs/SSO_V4_ENV_AUTH_RUNTIME.md)
  • Future Module Runtime Auth Onboarding (docs/FUTURE_MODULE_RUNTIME_AUTH_ONBOARDING.md)

Runbooks​

Step-by-step recovery and incident runbooks.

  • Client TLS Trust Runbook (docs/CLIENT_TLS_TRUST_RUNBOOK.md)
  • Gitea Org Runner Recovery Runbook (docs/GITEA_ORG_RUNNER_RECOVERY_RUNBOOK.md)
  • Host Checkout Hygiene (docs/HOST_CHECKOUT_HYGIENE.md)
  • Rollback and Recovery (docs/ROLLBACK_AND_RECOVERY.md)
  • Session Bootstrap (docs/SESSION_BOOTSTRAP.md)
  • AdGuard DNS Contract Runbook (docs/runbooks/RUNBOOK_ADGUARD_DNS_CONTRACT.md)
  • Windows/SChannel TLS Renewal Runbook (docs/runbooks/RUNBOOK_WINDOWS_SCHANNEL_TLS_RENEWAL.md)

Docs Platform v1.6 Base Family​

Plans​

Plans, roadmaps, and live execution evidence.

  • Fabric Wave 3 Adoption (docs/FABRIC_WAVE3_ADOPTION.md)
  • Fabric Wave 8 Infra Evidence (docs/FABRIC_WAVE8_INFRA_EVIDENCE.md)
  • Fabric Wave 8/9 Companion Status (future-wave companion) (docs/FABRIC_WAVE8_9_COMPANION_STATUS.md)
  • Plan — OpenClaw Env PKI (docs/PLAN_OPENCLAW_ENV_PKI.md)
  • Wave 9 — Secondary OpenClaw 73 (docs/WAVE9_SECONDARY_OPENCLAW_73.md)

Evidence​

  • Fabric Wave 8 Infra Evidence (docs/FABRIC_WAVE8_INFRA_EVIDENCE.md)
  • Live Operations Log (docs/LIVE_OPERATIONS_LOG.md)
  • Execution Track Fabric Run Ledger (docs/execution-track-fabric-run-ledger.md)

Historical / Compatibility​

  • OpenClaw Environment Baseline (legacy alias) (docs/OPENCLAW_ENVIRONMENT_BASELINE.md)
  • Deployment Boundary Audit (2026-04-26, archived) (docs/DEPLOYMENT_BOUNDARY_AUDIT_2026-04-26.md)

Archived issue snapshots stay under docs/issues/ as historical context only. Current issue authority remains the live Gitea issue state.

Release Admission Boundary​

The bounded public stack-nightly release surfaces for this repository are defined in:

  • contracts/admission/repository_publication_history_posture_v1.json (contracts/admission/repository_publication_history_posture_v1.json)
  • contracts/admission/release_surface_inventory_v1.json (contracts/admission/release_surface_inventory_v1.json)
  • PUBLIC_VS_INTERNAL_CONTENT.md (docs/PUBLIC_VS_INTERNAL_CONTENT.md)

Operator-only runtime, evidence, backlog, and host-specific documents remain in Gitea but are excluded from public release admission until a future owner issue changes that posture.

The current owner-bounded follow-up for that posture is JaddaHelpifyr/jhf-openclaw-env#1844. Repo-owned history evidence now runs through python scripts/verify_repository_history_posture.py and currently proves filtered_publication_required. The matching filtered bundle can only be built from a clean exact-main checkout with python scripts/build_filtered_publication_bundle.py build --output-dir <external-output-dir>; the command is preparation evidence and never publishes a repository.

External and cross-repo routing references.

  • External Blocker Routing (docs/EXTERNAL_BLOCKER_ROUTING.md)
  • Local Gitea API Path (docs/LOCAL_GITEA_API_PATH.md)
  • External Gitea API Path (docs/EXTERNAL_GITEA_API_PATH.md)

License: AGPLv3 Project: https://helpifyr.com

Evidence and Historical Material​

  • legacy and evidence surfaces remain supporting material in this repo.

Boost Adapter Sandbox Runtime

The bounded candidate/LKG adapter runtime and rollback procedure are documented in BOOST_ADAPTER_SANDBOX_RUNTIME.md (docs/BOOST_ADAPTER_SANDBOX_RUNTIME.md).