@2en/clawly-plugins 1.32.0-beta.0 → 1.32.0-beta.2

package/gateway/index.ts

@@ -23,6 +23,7 @@ import {registerPresence} from './presence'
 import {registerSessionSanitize} from './session-sanitize'
 import {registerUploadHttpRoute} from '../http/file/upload'
 import {registerVersion} from './version'
+import {registerWeixinLogin} from './weixin-login'
 
 export function registerGateway(api: PluginApi) {
   // Initialize OTel logs provider (no-op if plugin telemetry config is missing)
@@ -72,4 +73,5 @@ export function registerGateway(api: PluginApi) {
   registerUploadHttpRoute(api)
   registerAudit(api)
   registerCalendarNative(api)
+  registerWeixinLogin(api)
 }

package/gateway/weixin-login.ts

@@ -0,0 +1,140 @@
+/**
+ * WeChat (openclaw-weixin) QR login bridge.
+ *
+ * The official @tencent-weixin/openclaw-weixin plugin registers as a ChannelPlugin
+ * with loginWithQrStart/loginWithQrWait on its gateway adapter, but does NOT
+ * register as the `web.login.start` provider (WhatsApp owns that slot).
+ *
+ * These two gateway methods expose the WeChat plugin's login flow to the mobile app:
+ *   clawly.weixin.login.start → { qrDataUrl, message }
+ *   clawly.weixin.login.wait  → { connected, message }
+ */
+
+import type {PluginApi} from '../types'
+
+const WEIXIN_CHANNEL_ID = 'openclaw-weixin'
+const GATEWAY_TIMEOUT_MS = 60_000
+
+/** Race a promise against a timeout, clearing the timer on settle. */
+function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T> {
+  let timeoutId: ReturnType<typeof setTimeout> | undefined
+  const timeoutPromise = new Promise<never>((_, reject) => {
+    timeoutId = setTimeout(() => reject(new Error(`${label} timed out`)), ms)
+  })
+  return Promise.race([promise, timeoutPromise]).finally(() => clearTimeout(timeoutId))
+}
+
+type ChannelPluginLike = {
+  id: string
+  gateway?: {
+    loginWithQrStart?: (params: {
+      accountId?: string
+      force?: boolean
+      timeoutMs?: number
+      verbose?: boolean
+    }) => Promise<{qrDataUrl?: string; message: string}>
+    loginWithQrWait?: (params: {
+      accountId?: string
+      timeoutMs?: number
+    }) => Promise<{connected: boolean; message: string}>
+  }
+}
+
+/**
+ * Resolve the openclaw-weixin channel plugin from the host OpenClaw process.
+ *
+ * Accesses the plugin registry singleton via the well-known global symbol
+ * `Symbol.for("openclaw.pluginRegistryState")` (see openclaw/src/plugins/runtime.ts).
+ * This avoids importing internal OpenClaw paths that don't exist in the published
+ * npm package (bundled dist only).
+ *
+ * Assumed registry shape: `{ channels: Array<{ plugin: ChannelPlugin }> }`.
+ * Verified against OpenClaw 2026.3.x. If the shape changes, this returns null
+ * with a logged warning — re-verify after major OpenClaw upgrades.
+ */
+function resolveWeixinPlugin(logger?: {warn: (msg: string) => void}): ChannelPluginLike | null {
+  try {
+    const REGISTRY_STATE = Symbol.for('openclaw.pluginRegistryState')
+    const registryState = (globalThis as Record<symbol, unknown>)[REGISTRY_STATE] as
+      | {registry: {channels: Array<{plugin: ChannelPluginLike}>} | null}
+      | undefined
+    const channels = registryState?.registry?.channels
+    if (!channels) {
+      logger?.warn('weixin-login: plugin registry not available on globalThis')
+      return null
+    }
+    const entry = channels.find((e) => e.plugin?.id === WEIXIN_CHANNEL_ID)
+    return entry?.plugin ?? null
+  } catch (err) {
+    logger?.warn(
+      `weixin-login: failed to resolve channel plugin: ${err instanceof Error ? err.message : err}`,
+    )
+    return null
+  }
+}
+
+export function registerWeixinLogin(api: PluginApi) {
+  api.registerGatewayMethod('clawly.weixin.login.start', async ({params, respond}) => {
+    const plugin = resolveWeixinPlugin(api.logger)
+    if (!plugin?.gateway?.loginWithQrStart) {
+      respond(false, undefined, {
+        code: 'WEIXIN_PLUGIN_NOT_AVAILABLE',
+        message:
+          'WeChat plugin is not installed or does not support QR login. ' +
+          'Install it with: openclaw plugins install "@tencent-weixin/openclaw-weixin"',
+      })
+      return
+    }
+
+    try {
+      const p = (params ?? {}) as Record<string, unknown>
+      const result = await withTimeout(
+        plugin.gateway.loginWithQrStart({
+          accountId: p.accountId as string | undefined,
+          force: p.force !== undefined ? Boolean(p.force) : undefined,
+          timeoutMs: typeof p.timeoutMs === 'number' ? p.timeoutMs : undefined,
+          verbose: p.verbose !== undefined ? Boolean(p.verbose) : undefined,
+        }),
+        GATEWAY_TIMEOUT_MS,
+        'loginWithQrStart',
+      )
+      respond(true, result)
+    } catch (err) {
+      respond(false, undefined, {
+        code: 'WEIXIN_LOGIN_START_ERROR',
+        message: err instanceof Error ? err.message : 'Failed to start WeChat QR login',
+      })
+    }
+  })
+
+  api.registerGatewayMethod('clawly.weixin.login.wait', async ({params, respond}) => {
+    const plugin = resolveWeixinPlugin(api.logger)
+    if (!plugin?.gateway?.loginWithQrWait) {
+      respond(false, undefined, {
+        code: 'WEIXIN_PLUGIN_NOT_AVAILABLE',
+        message: 'WeChat plugin is not installed or does not support QR login.',
+      })
+      return
+    }
+
+    try {
+      const p = (params ?? {}) as Record<string, unknown>
+      const result = await withTimeout(
+        plugin.gateway.loginWithQrWait({
+          accountId: p.accountId as string | undefined,
+          timeoutMs: typeof p.timeoutMs === 'number' ? p.timeoutMs : undefined,
+        }),
+        GATEWAY_TIMEOUT_MS,
+        'loginWithQrWait',
+      )
+      respond(true, result)
+    } catch (err) {
+      respond(false, undefined, {
+        code: 'WEIXIN_LOGIN_WAIT_ERROR',
+        message: err instanceof Error ? err.message : 'Failed to wait for WeChat QR login',
+      })
+    }
+  })
+
+  api.logger.info('weixin-login: registered clawly.weixin.login.start/wait methods')
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.32.0-beta.0",
+  "version": "1.32.0-beta.2",
   "module": "index.ts",
   "type": "module",
   "repository": {