compat

clawvault compat [options]

# General compatibility check
clawvault compat

# Strict mode for CI (exits non-zero on warnings)
clawvault compat --strict

$ clawvault compat

 OpenClaw Compatibility Check

## OpenClaw CLI Readiness
- **OpenClaw CLI:** Found at /usr/local/bin/openclaw (v2026.2.13)
- **Version compatibility:** Supported
- **Basic functionality:** Working

## Hook Installation & Events
- **Hook installed:** /path/to/hooks/clawvault/
- **Hook enabled:** Active in OpenClaw 
- **Required events:** All supported
 - gateway:startup 
 - command:new 
 - session:start 
- **Event routing:** Configured correctly

## SKILL.md Metadata Compliance 
- **Skill file:** Found and valid
- **Required fields:** Complete
 - name: clawvault 
 - version: 2.0.0 
 - description: Present 
 - metadata.openclaw: Complete 
- **Hook metadata:** Matches hook directory

## Handler Safety & Profile Delegation
- **Safe execution:** No unsafe patterns detected
- **Profile delegation:** Supports --profile auto
- **Error handling:** Graceful degradation
- **Security compliance:** No shell injection risks

## Summary
**Status:** **Fully Compatible**
**Checks:** 15 passed, 0 warnings, 0 errors
**OpenClaw integration:** Ready for production use

All systems green! 

$ clawvault compat

 OpenClaw Compatibility Check

## OpenClaw CLI Readiness 
- **OpenClaw CLI:** Found at /usr/local/bin/openclaw (v2026.1.5)
- **Version compatibility:** Older version detected
- **Basic functionality:** Working

## Hook Installation & Events
- **Hook installed:** /path/to/hooks/clawvault/
- **Hook enabled:** Not enabled in OpenClaw
- **Required events:** All supported

## Recommended Actions
1. **Update OpenClaw:** Upgrade to v2026.2.0+ for latest features
2. **Enable hook:** Run `openclaw hooks enable clawvault`

**Status:** **Compatible with warnings**
**Checks:** 12 passed, 3 warnings, 0 errors

#!/bin/bash
# CI script
npm install -g clawvault
clawvault compat --strict

if [ $? -ne 0 ]; then
 echo " OpenClaw integration not ready"
 exit 1
fi

echo " ClawVault integration validated"

# Checks performed:
openclaw --version # CLI accessibility
openclaw help # Basic command execution

# Hook directory structure
hooks/clawvault/
├── handler.js # Event handler
├── package.json # Hook metadata 
└── README.md # Documentation

# Event support verification
# Checks that OpenClaw supports required events:
# - gateway:startup 
# - command:new
# - session:start

# Required SKILL.md fields checked:
metadata:
 openclaw:
 emoji: ""
 kind: "cli"
 requires:
 bins: ["clawvault"] 
 hooks:
 clawvault:
 events: ["gateway:startup", "command:new", "session:start"]

// Unsafe patterns detected:
execSync('command', { shell: true }) // Shell injection risk
process.exit(1) // Ungraceful termination

// Safe patterns:
execFileSync('clawvault', args) // No shell, arg array
process.exitCode = 1 // Graceful exit

# Verifies handler supports --profile auto for context queries
clawvault context "query" --profile auto

clawvault compat --format json

{
 "timestamp": "2026-02-13T14:30:00Z",
 "clawvaultVersion": "2.0.0",
 "openclawVersion": "2026.2.13",
 "status": "compatible",
 "checks": [
 {
 "category": "openclaw-cli",
 "name": "CLI Accessibility",
 "status": "pass",
 "details": "Found at /usr/local/bin/openclaw"
 },
 {
 "category": "hooks", 
 "name": "Hook Installation",
 "status": "pass",
 "details": "Hook installed and enabled"
 },
 {
 "category": "skill-metadata",
 "name": "SKILL.md Compliance", 
 "status": "pass",
 "details": "All required fields present"
 },
 {
 "category": "handler-safety",
 "name": "Safe Execution Patterns",
 "status": "warning",
 "details": "Minor: Consider using execFileSync over execSync",
 "hint": "Replace shell execution with direct binary calls"
 }
 ],
 "summary": {
 "totalChecks": 15,
 "passed": 14,
 "warnings": 1, 
 "errors": 0
 },
 "recommendations": [
 "Consider updating hook handler to use execFileSync"
 ]
}

name: ClawVault Compatibility

on: [push, pull_request]

jobs:
 compat:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v3
 
 - name: Install OpenClaw
 run: npm install -g openclaw
 
 - name: Install ClawVault 
 run: npm install -g clawvault
 
 - name: Validate Compatibility
 run: clawvault compat --strict --format json > compat-report.json
 
 - name: Upload Report
 uses: actions/upload-artifact@v3
 with:
 name: compatibility-report
 path: compat-report.json

compatibility-check:
 stage: test
 image: node:18
 script:
 - npm install -g openclaw clawvault
 - clawvault compat --strict
 artifacts:
 when: always
 reports:
 junit: compat-report.xml
 only:
 - merge_requests
 - main

# Pre-commit hook
#!/bin/bash
clawvault compat --strict
if [ $? -ne 0 ]; then
 echo "Fix OpenClaw compatibility issues before committing"
 exit 1
fi

$ clawvault compat
# Hook installation: Hook directory not found

# Fix:
openclaw hooks install clawvault
openclaw hooks enable clawvault

$ clawvault compat 
# OpenClaw version: v2026.1.0 detected, v2026.2.0+ recommended

# Fix:
npm update -g openclaw

$ clawvault compat
# Required events: session:start not supported

# Fix: Update OpenClaw to newer version with event support

$ clawvault compat
# SKILL metadata: Missing required field 'openclaw.hooks'

# Fix: Update SKILL.md with complete metadata

# Daily compatibility monitoring
0 9 * * * /usr/local/bin/clawvault compat --strict --format json > /var/log/clawvault-compat.json

# Alert on failures 
if ! clawvault compat --strict; then
 echo "ClawVault compatibility issue detected" | mail -s "Alert" admin@company.com
fi

# Generate health report
clawvault compat --format json | jq '.summary'

{
 "totalChecks": 15,
 "passed": 15,
 "warnings": 0,
 "errors": 0,
 "status": "healthy"
}