How to Automate OpenClaw Workflows with n8n

# 1. Go to n8n.io and sign up for n8n Cloud
# 2. Create a new workspace
# 3. Note your instance URL: https://your-workspace.app.n8n.cloud
# 4. You'll use this URL for webhook endpoints

# In config/webhooks.yaml:
webhooks:
  enabled: true
  endpoints:
    - name: n8n_automation
      url: "https://your-workspace.app.n8n.cloud/webhook/openclaw-events"
      events:
        - conversation.completed
        - task.completed
        - escalation.triggered
      headers:
        Authorization: "Bearer YOUR_N8N_WEBHOOK_SECRET"
      retry:
        max_attempts: 3
        backoff_seconds: 5

# In n8n Cloud:
# 1. Create a new workflow
# 2. Add a "Webhook" trigger node
#    - HTTP Method: POST
#    - Path: openclaw-events
#    - Authentication: Header Auth
#    - Header Name: Authorization
#    - Header Value: Bearer YOUR_N8N_WEBHOOK_SECRET
# 3. Add processing nodes after the webhook
# 4. Activate the workflow to get the live webhook URL
# 5. Copy the production URL back to OpenClaw's config

# HTTP Request node settings:
# Method: POST
# URL: http://your-openclaw-host:3000/api/v1/chat
# Authentication: Header Auth
#   Header Name: Authorization
#   Header Value: Bearer YOUR_OPENCLAW_API_KEY
# Body (JSON):
{
  "message": "{{ $json.prompt }}",
  "context": {
    "source": "n8n",
    "workflow_id": "{{ $workflow.id }}"
  }
}

# Example: Support ticket → OpenClaw summary → Slack
#
# Node 1: Webhook (receives ticket from helpdesk)
# Node 2: HTTP Request (sends ticket text to OpenClaw for summarization)
# Node 3: IF node (check if priority is high)
#   → True: Slack node (post to #urgent-support)
#   → False: Slack node (post to #support-queue)
#
# n8n expressions for the Slack message:
# "New {{ $node["Webhook"].json.priority }} ticket:
#  {{ $node["OpenClaw"].json.response }}"

# In n8n:
# 1. Click the workflow settings (gear icon)
# 2. Set "Error Workflow" to a dedicated error-handling workflow
#
# Error workflow nodes:
# Node 1: Error Trigger
# Node 2: Slack notification with error details:
#   "Workflow {{ $json.workflow.name }} failed:
#    {{ $json.execution.error.message }}"
# Node 3: (Optional) HTTP Request to log error to your monitoring system
#
# On individual nodes:
# - Settings → "Continue On Fail" for non-critical steps
# - Settings → "Retry On Fail" with max 3 retries for API calls

# Testing:
# 1. Click "Test workflow" in n8n
# 2. Send a test event from OpenClaw:
openclaw webhook test n8n_automation --event conversation.completed

# 3. Check the n8n execution log for the test run
# 4. Verify each node received and processed data correctly
# 5. Once confirmed, toggle the workflow to "Active"

# Monitor in production:
# n8n Cloud → Executions → filter by workflow