@2en/clawly-plugins 1.32.0 → 1.33.1

package/auto-pair.ts

@@ -37,7 +37,15 @@ export function registerAutoPair(api: PluginApi) {
 
   api.on('gateway_start', async () => {
     try {
-      sdk = await import('openclaw/plugin-sdk')
+      // v2026.3.23+ moved pairing functions to device-bootstrap subpath;
+      // older versions export them from the main plugin-sdk index.
+      try {
+        sdk = await import('openclaw/plugin-sdk/device-bootstrap')
+      } catch (err: unknown) {
+        const code = (err as NodeJS.ErrnoException)?.code
+        if (code !== 'ERR_MODULE_NOT_FOUND' && code !== 'ERR_PACKAGE_PATH_NOT_EXPORTED') throw err
+        sdk = await import('openclaw/plugin-sdk')
+      }
     } catch {
       api.logger.warn('auto-pair: openclaw/plugin-sdk not available, skipping')
       return

package/clawly-config-defaults.json5

@@ -77,6 +77,13 @@
             contextWindow: 196608,
             maxTokens: 196608,
           },
+          {
+            id: "qwen/qwen3.5-flash-02-23",
+            name: "qwen/qwen3.5-flash-02-23",
+            input: ["text", "image"],
+            contextWindow: 1000000,
+            maxTokens: 65536,
+          },
           {
             id: "qwen/qwen3.5-plus-02-15",
             name: "qwen/qwen3.5-plus-02-15",

package/index.ts

@@ -55,6 +55,7 @@ import {
   registerOutboundHttpRoute,
   registerOutboundMethods,
 } from './http/file/outbound'
+import {registerMediaUnderstanding} from './media-understanding'
 import {registerSkillCommandRestore} from './skill-command-restore'
 import {registerTools} from './tools'
 import type {PluginApi} from './types'
@@ -83,6 +84,7 @@ export default {
     registerGateway(api)
     registerAutoPair(api)
     registerAutoUpdate(api)
+    registerMediaUnderstanding(api)
 
     // Email & calendar (optional — requires API base URL + token)
     const gw = getGatewayConfig(api)

package/media-understanding.ts

@@ -0,0 +1,44 @@
+import {PROVIDER_NAME} from './model-gateway-setup'
+import type {PluginApi} from './types'
+
+type MediaSdk = {
+  describeImageWithModel: (...args: unknown[]) => Promise<unknown>
+  describeImagesWithModel: (...args: unknown[]) => Promise<unknown>
+}
+
+let sdkPromise: Promise<MediaSdk | null> | null = null
+
+function loadSdk(logger: PluginApi['logger']): Promise<MediaSdk | null> {
+  if (!sdkPromise) {
+    sdkPromise = import('openclaw/plugin-sdk/media-understanding').catch((err: unknown) => {
+      const code = (err as NodeJS.ErrnoException)?.code
+      if (code === 'ERR_MODULE_NOT_FOUND' || code === 'ERR_PACKAGE_PATH_NOT_EXPORTED') {
+        logger.warn(
+          'media-understanding: openclaw/plugin-sdk/media-understanding not available, skipping',
+        )
+        return null
+      }
+      throw err
+    })
+  }
+  return sdkPromise
+}
+
+export function registerMediaUnderstanding(api: PluginApi): void {
+  if (!api.registerMediaUnderstandingProvider) return
+
+  api.registerMediaUnderstandingProvider({
+    id: PROVIDER_NAME,
+    capabilities: ['image'],
+    describeImage: async (...args: unknown[]) => {
+      const sdk = await loadSdk(api.logger)
+      if (!sdk) return undefined
+      return sdk.describeImageWithModel(...args)
+    },
+    describeImages: async (...args: unknown[]) => {
+      const sdk = await loadSdk(api.logger)
+      if (!sdk) return undefined
+      return sdk.describeImagesWithModel(...args)
+    },
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.32.0",
+  "version": "1.33.1",
   "module": "index.ts",
   "type": "module",
   "repository": {
@@ -34,6 +34,7 @@
     "email.ts",
     "gateway-fetch.ts",
     "http",
+    "media-understanding.ts",
     "model-gateway-setup.ts",
     "resolve-gateway-credentials.ts",
     "skill-command-restore.ts",

package/types.ts

@@ -256,6 +256,14 @@ export type PluginApi = {
     stop?: (...args: unknown[]) => void | Promise<void>
   }) => void
   registerProvider: (provider: Record<string, unknown>) => void
+  registerMediaUnderstandingProvider?: (provider: {
+    id: string
+    capabilities?: Array<'image' | 'audio' | 'video'>
+    describeImage?: (...args: unknown[]) => Promise<unknown>
+    describeImages?: (...args: unknown[]) => Promise<unknown>
+    transcribeAudio?: (...args: unknown[]) => Promise<unknown>
+    describeVideo?: (...args: unknown[]) => Promise<unknown>
+  }) => void
   registerContextEngine: (id: string, factory: (...args: unknown[]) => unknown) => void
   resolvePath: (input: string) => string
   on: <K extends PluginHookName>(