# OpenClaw Integration Docs

Status: Canonical landing page

## Operator quick path (recommended)
- Install/harden bridge: `../../../scripts/openclaw_bridge_install.sh`
- Verify health: `../../../scripts/openclaw_bridge_doctor.sh`
- Synthetic append smoke gate: `../../../scripts/openclaw_bridge_ci_smoke.sh`

## Canonical sources
- `canonical_contract.md`  ← single canonical contract path
- `core-memory-skill-instructions.md`
- `plugin-setup.md`
- `validation.md`
- `troubleshooting.md`
- `agent_end_bridge.md`
- `api-reference.md`
- `../../public_surface.md`
- repository root `README.md`

## Runtime prompt source

- Runtime-injected prompt mirror: `AGENT_INSTRUCTIONS.md`
- Keep it mirrored from `docs/integrations/openclaw/canonical_contract.md` to avoid drift.

## Operational notes
- Forward retrieval story is `search` / `trace` / `execute` (`execute` preferred by default policy).
- Hydration is optional post-selection source recovery, not the primary retrieval mode.
- For plugin `api.on(...)` lifecycle listeners, do **not** rely solely on `openclaw hooks list --json`.
- Primary runtime signals are:
  - `/tmp/core-memory-bridge-hook.log` movement
  - `.beads/events/memory-events.jsonl` append progression
  - `.beads/events/memory-pass-status.jsonl` append progression
  - absence of blocked/stale plugin warnings
