docs: OpenClaw integration across all documentation

- forge-export.md: added openclaw to dispatch options
- README: added integrations/ to architecture diagram (EN + ES)
- architecture-components.md: new Integrations section with OpenClaw
  bridge skill and export mechanisms
- changelog: v2.2.0 entry updated with OpenClaw features
- CLAUDE.md: Integrations subsection in Architecture

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: luiseiman

CLAUDE.md

@@ -69,6 +69,10 @@ Six subagent definitions in `agents/`: researcher (read-only exploration), archi
 
 `audit/checklist.md` defines 12 items (5 obligatory scored 0-2, 7 recommended scored 0-1). `audit/scoring.md` normalizes to a 10-point scale. Security-critical items (settings.json, block-destructive hook) cap the score at 6.0 if missing. Registry in `registry/projects.yml` tracks scores across managed projects.
 
+### Integrations
+
+`integrations/` contains cross-tool bridges. Currently: OpenClaw (`integrations/openclaw/`) with a bridge skill for operating `/forge` from messaging channels, and `/forge export openclaw` for generating project-specific OpenClaw workspace skills.
+
 ## Conventions
 
 - Rules files: markdown with `globs:` frontmatter for auto-load

README.md

@@ -79,8 +79,9 @@ claude-kit/
 ├── global/         # Global ~/.claude/ management (CLAUDE.md, settings, sync.sh)
 ├── registry/       # Project tracking with scores and history
 ├── hooks/          # Global post-session change detection hook
+├── integrations/   # Cross-tool bridges (OpenClaw)
 ├── docs/           # Guides, patterns, security checklist
-└── tests/          # Hook test suite
+└── tests/          # Hook test suite + benchmark tasks
 ```
 
 ## Stacks
@@ -278,8 +279,9 @@ claude-kit/
 ├── global/         # Gestión global de ~/.claude/ (CLAUDE.md, settings, sync.sh)
 ├── registry/       # Seguimiento de proyectos con puntajes e historial
 ├── hooks/          # Hook global post-sesión para detección de cambios
+├── integrations/   # Bridges cross-tool (OpenClaw)
 ├── docs/           # Guías, patrones, checklist de seguridad
-└── tests/          # Suite de tests para hooks
+└── tests/          # Suite de tests para hooks + benchmark tasks
 ```
 
 ## Stacks

docs/changelog.md

@@ -6,9 +6,12 @@
 
 ## v2.2.0 (2026-03-20)
 
-### CI/CD + Quality
+### CI/CD + Quality + OpenClaw Integration
 - Nuevo: GitHub Actions CI workflow — validates hooks (bash -n + permissions), YAML files, rules frontmatter, stack completeness, skill completeness, benchmark tasks, version consistency
 - Nuevo: `tests/lint-rules.sh` — validates all rule .md files have `globs:` frontmatter
+- Nuevo: `integrations/openclaw/` — bridge skill que permite operar `/forge` desde WhatsApp, Telegram, Slack, Discord via OpenClaw
+- Nuevo: `/forge export openclaw` — genera un workspace skill de OpenClaw por proyecto con contexto, reglas, deny list, y bridge CLI
+- Cambio: `forge-export.md` y export-config skill actualizados con OpenClaw como cuarto target
 - Fix: plugin.json version synced to VERSION file (CI catches mismatches)
 
 ---

docs/internal/architecture-components.md

@@ -14,6 +14,9 @@ Internal reference for claude-kit contributors. Maps all components and their in
 │                        global/                                   │
 │              (~/.claude/ management via sync.sh)                  │
 ├─────────────────────────────────────────────────────────────────┤
+│                    integrations/                                  │
+│              (cross-tool bridges: OpenClaw)                       │
+├─────────────────────────────────────────────────────────────────┤
 │                      registry/                                   │
 │              (cross-project tracking)                             │
 └─────────────────────────────────────────────────────────────────┘
@@ -158,3 +161,27 @@ See `docs/config-validation.md` for full documentation. Four layers:
 | Behavioral | `session-report.sh` | Session metrics (blocks, coverage, errors) |
 | Coverage | `/forge rule-check` | Rule match rate against git history |
 | Comparative | `/forge benchmark` | Full config vs minimal config on standard tasks |
+
+## Integrations
+
+`integrations/` contains cross-tool bridges that let other platforms use claude-kit.
+
+### OpenClaw (`integrations/openclaw/`)
+
+Two mechanisms:
+
+1. **Bridge skill** (`integrations/openclaw/SKILL.md`) — standalone OpenClaw skill that proxies all `/forge` commands via `claude --print`. Install with `bash integrations/openclaw/install.sh` → symlinks into `~/.openclaw/skills/forge/`.
+
+2. **Export** (`/forge export openclaw`) — generates a project-specific OpenClaw workspace skill at `~/.openclaw/skills/{project}/SKILL.md` with project context, rules, deny list, and claude CLI bridge. Part of the standard export-config skill.
+
+| Mechanism | Scope | Content |
+|-----------|-------|---------|
+| Bridge skill | All projects | Proxies `/forge` commands, resolves project from registry |
+| Export | Single project | Project-specific context, rules as instructions, CLI bridge |
+
+### Adding new integrations
+
+Each integration lives in `integrations/<tool>/` with:
+- `SKILL.md` or equivalent config in the target tool's format
+- `install.sh` for automated setup
+- Documentation of what's preserved vs lost in the conversion

global/commands/forge-export.md

@@ -1,6 +1,6 @@
 ---
 name: forge-export
-description: Export config to Cursor (.cursorrules), Codex (AGENTS.md), or Windsurf (.windsurfrules)
+description: Export config to Cursor (.cursorrules), Codex (AGENTS.md), Windsurf (.windsurfrules), or OpenClaw (SKILL.md)
 ---
 
-Run `/forge export` with target from $ARGUMENTS (cursor|codex|windsurf). Converts the project's claude-kit configuration to the target editor's format.
+Run `/forge export` with target from $ARGUMENTS (cursor|codex|windsurf|openclaw). Converts the project's claude-kit configuration to the target editor's format.