@openclaw/twitch 2026.2.21 → 2026.5.2-beta.1

package/README.md

@@ -5,7 +5,7 @@ Twitch channel plugin for OpenClaw.
 ## Install (local checkout)
 
 ```bash
-openclaw plugins install ./extensions/twitch
+openclaw plugins install ./path/to/local/twitch-plugin
 ```
 
 ## Install (npm)
@@ -31,7 +31,7 @@ Minimal config (simplified single-account):
       accessToken: "oauth:abc123...", // OAuth Access Token (add oauth: prefix)
       clientId: "xyz789...", // Client ID from Token Generator
       channel: "vevisk", // Channel to join (required)
-      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only (Convert your twitch username to ID at https://www.streamweasels.com/tools/convert-twitch-username-%20to-user-id/)
+      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only (Convert your twitch username to ID at https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/)
     },
   },
 }

package/api.ts

@@ -0,0 +1,21 @@
+export {
+  type ChannelAccountSnapshot,
+  type ChannelCapabilities,
+  type ChannelGatewayContext,
+  type ChannelLogSink,
+  type ChannelMessageActionAdapter,
+  type ChannelMessageActionContext,
+  type ChannelMeta,
+  type ChannelOutboundAdapter,
+  type ChannelOutboundContext,
+  type ChannelPlugin,
+  type ChannelResolveKind,
+  type ChannelResolveResult,
+  type ChannelStatusAdapter,
+  type OpenClawConfig,
+  type OutboundDeliveryResult,
+  type RuntimeEnv,
+  type WizardPrompter,
+} from "./runtime-api.js";
+export { twitchPlugin } from "./src/plugin.js";
+export { setTwitchRuntime } from "./src/runtime.js";

package/channel-plugin-api.ts

@@ -0,0 +1 @@
+export { twitchPlugin } from "./src/plugin.js";

package/index.test.ts

@@ -0,0 +1,13 @@
+import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
+import { describe } from "vitest";
+import entry from "./index.js";
+import setupEntry from "./setup-entry.js";
+
+describe("twitch bundled entries", () => {
+  assertBundledChannelEntries({
+    entry,
+    expectedId: "twitch",
+    expectedName: "Twitch",
+    setupEntry,
+  });
+});

package/index.ts

@@ -1,20 +1,16 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
-import { twitchPlugin } from "./src/plugin.js";
-import { setTwitchRuntime } from "./src/runtime.js";
+import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
-export { monitorTwitchProvider } from "./src/monitor.js";
-
-const plugin = {
+export default defineBundledChannelEntry({
   id: "twitch",
   name: "Twitch",
-  description: "Twitch channel plugin",
-  configSchema: emptyPluginConfigSchema(),
-  register(api: OpenClawPluginApi) {
-    setTwitchRuntime(api.runtime);
-    // oxlint-disable-next-line typescript/no-explicit-any
-    api.registerChannel({ plugin: twitchPlugin as any });
+  description: "Twitch IRC chat channel plugin",
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./channel-plugin-api.js",
+    exportName: "twitchPlugin",
   },
-};
-
-export default plugin;
+  runtime: {
+    specifier: "./api.js",
+    exportName: "setTwitchRuntime",
+  },
+});

package/openclaw.plugin.json

@@ -1,9 +1,232 @@
 {
   "id": "twitch",
-  "channels": ["twitch"],
+  "activation": {
+    "onStartup": false
+  },
+  "channels": [
+    "twitch"
+  ],
+  "channelEnvVars": {
+    "twitch": [
+      "OPENCLAW_TWITCH_ACCESS_TOKEN"
+    ]
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
+  },
+  "channelConfigs": {
+    "twitch": {
+      "schema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "enabled": {
+                "type": "boolean"
+              },
+              "markdown": {
+                "type": "object",
+                "properties": {
+                  "tables": {
+                    "type": "string",
+                    "enum": [
+                      "off",
+                      "bullets",
+                      "code",
+                      "block"
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "defaultAccount": {
+                "type": "string"
+              },
+              "username": {
+                "type": "string"
+              },
+              "accessToken": {
+                "type": "string"
+              },
+              "clientId": {
+                "type": "string"
+              },
+              "channel": {
+                "type": "string",
+                "minLength": 1
+              },
+              "allowFrom": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "allowedRoles": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "moderator",
+                    "owner",
+                    "vip",
+                    "subscriber",
+                    "all"
+                  ]
+                }
+              },
+              "requireMention": {
+                "type": "boolean"
+              },
+              "responsePrefix": {
+                "type": "string"
+              },
+              "clientSecret": {
+                "type": "string"
+              },
+              "refreshToken": {
+                "type": "string"
+              },
+              "expiresIn": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "obtainmentTimestamp": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "username",
+              "accessToken",
+              "channel"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "enabled": {
+                "type": "boolean"
+              },
+              "markdown": {
+                "type": "object",
+                "properties": {
+                  "tables": {
+                    "type": "string",
+                    "enum": [
+                      "off",
+                      "bullets",
+                      "code",
+                      "block"
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "defaultAccount": {
+                "type": "string"
+              },
+              "accounts": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "object",
+                  "properties": {
+                    "username": {
+                      "type": "string"
+                    },
+                    "accessToken": {
+                      "type": "string"
+                    },
+                    "clientId": {
+                      "type": "string"
+                    },
+                    "channel": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "allowFrom": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "allowedRoles": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "enum": [
+                          "moderator",
+                          "owner",
+                          "vip",
+                          "subscriber",
+                          "all"
+                        ]
+                      }
+                    },
+                    "requireMention": {
+                      "type": "boolean"
+                    },
+                    "responsePrefix": {
+                      "type": "string"
+                    },
+                    "clientSecret": {
+                      "type": "string"
+                    },
+                    "refreshToken": {
+                      "type": "string"
+                    },
+                    "expiresIn": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "obtainmentTimestamp": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "username",
+                    "accessToken",
+                    "channel"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "accounts"
+            ],
+            "additionalProperties": false
+          }
+        ]
+      },
+      "label": "Twitch",
+      "description": "Twitch chat integration"
+    }
   }
 }

package/package.json

@@ -1,20 +1,49 @@
 {
   "name": "@openclaw/twitch",
-  "version": "2026.2.21",
+  "version": "2026.5.2-beta.1",
   "description": "OpenClaw Twitch channel plugin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw"
+  },
   "type": "module",
   "dependencies": {
-    "@twurple/api": "^8.0.3",
-    "@twurple/auth": "^8.0.3",
-    "@twurple/chat": "^8.0.3",
-    "zod": "^4.3.6"
+    "@twurple/api": "^8.1.3",
+    "@twurple/auth": "^8.1.3",
+    "@twurple/chat": "^8.1.3"
   },
   "devDependencies": {
-    "openclaw": "workspace:*"
+    "@openclaw/plugin-sdk": "workspace:*"
   },
   "openclaw": {
     "extensions": [
       "./index.ts"
-    ]
+    ],
+    "setupEntry": "./setup-entry.ts",
+    "install": {
+      "npmSpec": "@openclaw/twitch",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.4.10"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.2-beta.1"
+    },
+    "build": {
+      "openclawVersion": "2026.5.2-beta.1"
+    },
+    "channel": {
+      "id": "twitch",
+      "label": "Twitch",
+      "selectionLabel": "Twitch (Chat)",
+      "docsPath": "/channels/twitch",
+      "blurb": "Twitch chat integration",
+      "aliases": [
+        "twitch-chat"
+      ]
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
   }
 }

package/runtime-api.ts

@@ -0,0 +1,22 @@
+// Private runtime barrel for the bundled Twitch extension.
+// Keep this barrel thin and aligned with the local extension surface.
+
+export type {
+  ChannelAccountSnapshot,
+  ChannelCapabilities,
+  ChannelGatewayContext,
+  ChannelLogSink,
+  ChannelMessageActionAdapter,
+  ChannelMessageActionContext,
+  ChannelMeta,
+  ChannelOutboundAdapter,
+  ChannelOutboundContext,
+  ChannelResolveKind,
+  ChannelResolveResult,
+  ChannelStatusAdapter,
+} from "openclaw/plugin-sdk/channel-contract";
+export type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
+export type { OutboundDeliveryResult } from "openclaw/plugin-sdk/channel-send-result";
+export type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
+export type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
+export type { WizardPrompter } from "openclaw/plugin-sdk/setup";

package/setup-entry.ts

@@ -0,0 +1,9 @@
+import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelSetupEntry({
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./setup-plugin-api.js",
+    exportName: "twitchSetupPlugin",
+  },
+});

package/setup-plugin-api.ts

@@ -0,0 +1,3 @@
+// Keep bundled setup entry imports narrow so setup loads do not pull the
+// broader Twitch channel plugin surface.
+export { twitchSetupPlugin } from "./src/setup-surface.js";