@kittymi/openclaw-generic-http 0.1.3

package/openclaw.plugin.json

@@ -0,0 +1,175 @@
+{
+  "id": "openclaw-generic-http",
+  "name": "Generic HTTP",
+  "version": "0.1.2",
+  "description": "Generic HTTP channel plugin for OpenClaw",
+  "activation": {
+    "onStartup": false
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  },
+  "entry": "./dist/index.js",
+  "setupEntry": "./dist/setup-entry.js",
+  "setup": {
+    "channelName": "generic-http",
+    "title": "Generic HTTP Channel Setup",
+    "summary": "Configure a bridge/relay account, wire third-party webhooks into bridge ingress, and consume inbound events through stream polling.",
+    "configSchema": "./openclaw.config.schema.json",
+    "accountFields": [
+      {
+        "key": "baseUrl",
+        "title": "Bridge Base URL",
+        "required": true,
+        "description": "Base URL of the bridge or relay service that exposes health, probe, stream, resolve, and outbound endpoints."
+      },
+      {
+        "key": "apiKey",
+        "title": "API Key",
+        "required": false,
+        "description": "Optional shared credential sent on signed requests when the bridge requires API key authentication.",
+        "secret": true
+      },
+      {
+        "key": "signingSecret",
+        "title": "Signing Secret",
+        "required": false,
+        "description": "Shared secret used to sign stream, probe, resolve, and outbound requests from the plugin.",
+        "secret": true
+      },
+      {
+        "key": "inboundSecret",
+        "title": "Inbound Secret",
+        "required": false,
+        "description": "Optional dedicated secret used by the bridge when validating third-party webhook ingress.",
+        "secret": true
+      },
+      {
+        "key": "outboundSecret",
+        "title": "Outbound Secret",
+        "required": false,
+        "description": "Optional dedicated secret used when outbound message signing is separated from other transport signing.",
+        "secret": true
+      }
+    ],
+    "steps": [
+      {
+        "id": "configure-account",
+        "title": "Configure bridge account",
+        "description": "Add at least one account with baseUrl and the shared credentials required by the bridge or relay."
+      },
+      {
+        "id": "wire-webhook-ingress",
+        "title": "Wire webhook ingress",
+        "description": "Send third-party inbound events to POST /webhooks/inbound/messages on the bridge instead of calling a local OpenClaw URL."
+      },
+      {
+        "id": "activate-stream-ingress",
+        "title": "Activate stream ingress",
+        "description": "Let the host activate the plugin so it can poll GET /stream/inbound and acknowledge processed messages through POST /stream/acks."
+      },
+      {
+        "id": "verify-outbound-delivery",
+        "title": "Verify outbound delivery",
+        "description": "Confirm the bridge accepts POST /outbound/messages and that the external system returns successful delivery responses."
+      }
+    ]
+  },
+  "channels": [
+    "generic-http"
+  ],
+  "channelConfigs": {
+    "generic-http": {
+      "schema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "title": "Generic HTTP Channel Config",
+        "description": "Configuration for the OpenClaw generic HTTP channel plugin using bridge/relay webhook and stream ingress.",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "title": "Enabled",
+            "description": "Whether the generic HTTP channel is enabled.",
+            "default": false
+          },
+          "defaultAccount": {
+            "type": "string",
+            "title": "Default Account",
+            "description": "Default account ID used when the host does not specify one."
+          },
+          "accounts": {
+            "type": "object",
+            "title": "Accounts",
+            "description": "Per-account bridge and outbound transport settings.",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "baseUrl": {
+                  "type": "string",
+                  "format": "uri",
+                  "title": "Bridge Base URL",
+                  "description": "Bridge or relay base URL used for probe, resolve, stream ingress, and outbound delivery."
+                },
+                "apiKey": {
+                  "type": "string",
+                  "title": "API Key",
+                  "description": "Optional shared credential for bridge authentication."
+                },
+                "signingSecret": {
+                  "type": "string",
+                  "title": "Signing Secret",
+                  "description": "Shared secret used for signing outbound and stream transport requests."
+                },
+                "inboundSecret": {
+                  "type": "string",
+                  "title": "Inbound Secret",
+                  "description": "Optional dedicated secret for inbound webhook validation on the bridge side."
+                },
+                "outboundSecret": {
+                  "type": "string",
+                  "title": "Outbound Secret",
+                  "description": "Optional dedicated secret for outbound signing when outbound trust is split from inbound."
+                },
+                "connectTimeoutMillis": {
+                  "type": "number",
+                  "minimum": 0,
+                  "title": "Connect Timeout (ms)",
+                  "description": "HTTP connect timeout in milliseconds.",
+                  "default": 5000
+                },
+                "readTimeoutMillis": {
+                  "type": "number",
+                  "minimum": 0,
+                  "title": "Read Timeout (ms)",
+                  "description": "HTTP read timeout in milliseconds.",
+                  "default": 10000
+                },
+                "maxRetries": {
+                  "type": "number",
+                  "minimum": 0,
+                  "title": "Max Retries",
+                  "description": "Maximum retry count for retryable outbound HTTP failures.",
+                  "default": 0
+                }
+              },
+              "required": [
+                "baseUrl"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "enabled",
+          "defaultAccount",
+          "accounts"
+        ],
+        "additionalProperties": false
+      },
+      "label": "Generic HTTP",
+      "description": "Bridge external systems into OpenClaw through webhook ingress and stream polling."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@kittymi/openclaw-generic-http",
+  "version": "0.1.3",
+  "description": "OpenClaw channel plugin for the generic HTTP protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.config.schema.json",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "channel",
+    "http",
+    "bridge"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KittyMi/openclaw-generic-http.git"
+  },
+  "homepage": "https://github.com/KittyMi/openclaw-generic-http",
+  "bugs": {
+    "url": "https://github.com/KittyMi/openclaw-generic-http/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "openclaw": {
+    "pluginManifest": "./openclaw.plugin.json",
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "setupEntry": "./dist/setup-entry.js",
+    "runtimeSetupEntry": "./dist/setup-entry.js",
+    "setupFeatures": {
+      "configPromotion": true
+    },
+    "channel": {
+      "id": "generic-http",
+      "label": "Generic HTTP",
+      "selectionLabel": "Generic HTTP",
+      "detailLabel": "Generic HTTP Bridge",
+      "docsPath": "/channels/generic-http",
+      "docsLabel": "generic-http",
+      "blurb": "Bridge external systems into OpenClaw through webhook ingress and stream polling.",
+      "markdownCapable": false
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "typescript": "^5.8.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "pack:check": "node -e \"require('node:child_process').execSync('npm pack --dry-run',{stdio:'inherit'});\"",
+    "test": "vitest run",
+    "test:e2e": "npm run build && node scripts/e2e-bridge-regression.mjs"
+  }
+}