oem-agent-hooks

name: oem-agent-hooks description: OpenClaw integration hooks for automated maintenance, health monitoring, reporting, and vector embedding synchronization.

OEM Agent Hooks

Integration hooks for OpenClaw's cron system providing automated maintenance and monitoring capabilities.

Actions

health_check

Monitors cache health and triggers repairs when degradation is detected.

Configuration:

{
  "action": "health_check",
  "thresholds": {
    "selector_success_rate": 0.7,
    "api_success_rate": 0.8,
    "max_consecutive_failures": 3
  },
  "auto_repair": true,
  "notify_on_degradation": true
}

Output: Health status for all cached OEMs with recommendations.

memory_sync

Persists in-memory discovery cache to filesystem for cross-session retention.

Configuration:

{
  "action": "memory_sync",
  "storage_path": "discoveries/",
  "backup_enabled": true,
  "backup_retention_days": 7
}

generate_report

Creates weekly/monthly extraction performance summaries.

Configuration:

{
  "action": "generate_report",
  "report_type": "weekly_summary",
  "include_metrics": [
    "total_extractions",
    "success_rate",
    "selector_repairs",
    "api_discoveries",
    "cost_breakdown"
  ],
  "notify_channel": "slack:#oem-reports"
}

sync_embeddings

Generates vector embeddings for products, offers, and change events to enable semantic search.

Configuration:

{
  "action": "sync_embeddings",
  "tables": ["products", "offers", "change_events"],  // Also: vehicle_models, variant_colors, variant_pricing
  "batch_size": 50,
  "provider": "gemini",
  "model": "text-embedding-004",
  "max_items_per_run": 200
}

vectorize_pdfs

Vectorizes brochure and brand guidelines PDFs for semantic search via search_pdfs_semantic().

Configuration:

{
  "action": "vectorize_pdfs",
  "source_types": ["brochure", "guidelines"],
  "chunk_size": 1000,
  "chunk_overlap": 200,
  "provider": "gemini",
  "model": "text-embedding-004"
}

Supported Providers:

Output:

{
  "products": { "processed": 45, "errors": 0 },
  "offers": { "processed": 12, "errors": 0 },
  "change_events": { "processed": 28, "errors": 1 },
  "total_tokens": 15420,
  "estimated_cost_usd": 0.0154
}

validate_onboarding

Validates that a newly onboarded OEM was set up correctly by checking all required database records.

Configuration:

{
  "action": "validate_onboarding",
  "oem_id": "foton-au"
}

Checks performed:

1. OEM record exists in oems table with is_active = true
2. Source pages seeded in source_pages (homepage + at least 1 vehicle page)
3. Discovered APIs recorded in discovered_apis (if any were found)
4. OEM config_json has required fields (homepage, vehicles_index, schedule)

Output:

{
  "oem_id": "foton-au",
  "checks": {
    "oem_record": { "pass": true, "name": "Foton Australia", "base_url": "https://www.fotonaustralia.com.au" },
    "source_pages": { "pass": true, "count": 8, "types": ["homepage", "vehicle", "category", "other", "news"] },
    "discovered_apis": { "pass": true, "count": 1, "types": ["pricing"] },
    "config_json": { "pass": true, "has_schedule": true, "has_vehicles_index": true }
  },
  "overall": "pass"
}

Reference: See /root/clawd/docs/OEM_ONBOARDING.md for the full onboarding checklist.

repair_selectors

Manually triggers self-healing selector repair for degraded OEMs.

Configuration:

{
  "action": "repair_selectors",
  "oem_ids": ["kia-au", "hyundai-au"]
}

cleanup

Removes stale cache entries and optimizes storage.

Prerequisites

Cron Schedule

These hooks are typically scheduled via OpenClaw cron:

Triggered By

• OpenClaw cron scheduler
• Manual invocation via skill handler
• Webhook triggers (future)

Output

All actions return a HookResult:

interface HookResult {
  success: boolean;
  action: string;
  timestamp: string;
  data?: unknown;
  errors?: string[];
}