gewe-openclaw 2026.1.29 → 2026.1.31

package/README.md

@@ -32,6 +32,81 @@ openclaw plugins install ./gewe-openclaw.tgz
 
 > 安装或启用插件后需要重启 Gateway。
 
+## 配置
+
+插件配置放在 `~/.openclaw/openclaw.json` 的 `channels.gewe-openclaw`，并确保插件开启：
+
+```json5
+{
+  "plugins": {
+    "entries": {
+      "gewe-openclaw": { "enabled": true }
+    }
+  },
+  "channels": {
+    "gewe-openclaw": {
+      "enabled": true,
+      "apiBaseUrl": "https://www.geweapi.com",
+      "token": "<gewe-token>",
+      "appId": "<gewe-app-id>",
+      "webhookHost": "0.0.0.0",
+      "webhookPort": 4399,
+      "webhookPath": "/webhook",
+      "mediaHost": "0.0.0.0",
+      "mediaPort": 4400,
+      "mediaPath": "/gewe-media",
+      "mediaPublicUrl": "https://your-public-domain/gewe-media",
+      "allowFrom": ["wxid_xxx"]
+    }
+  }
+}
+```
+
+说明：
+- `webhookHost/webhookPort/webhookPath`：GeWe 回调入口（需公网可达，常配合 FRP）。
+- `mediaPublicUrl`：公网访问地址，供微信拉取媒体。
+- `allowFrom`：允许私聊触发的微信 ID（或在群里走 allowlist 规则）。
+
+> 配置变更后需重启 Gateway。
+
+## 在 onboarding 列表中显示（可选）
+
+OpenClaw 支持外部插件目录（catalog）。放置到以下路径即可被 onboarding 读取：
+
+```
+~/.openclaw/plugins/catalog.json
+```
+
+示例（只需添加一次）：
+
+```json
+{
+  "entries": [
+    {
+      "name": "gewe-openclaw",
+      "openclaw": {
+        "channel": {
+          "id": "gewe-openclaw",
+          "label": "GeWe",
+          "selectionLabel": "WeChat (GeWe)",
+          "detailLabel": "WeChat (GeWe)",
+          "docsPath": "/channels/gewe-openclaw",
+          "docsLabel": "gewe-openclaw",
+          "blurb": "WeChat channel via GeWe API and webhook callbacks.",
+          "aliases": ["gewe-openclaw", "gewe", "wechat", "wx"],
+          "order": 72,
+          "quickstartAllowFrom": true
+        },
+        "install": {
+          "npmSpec": "gewe-openclaw",
+          "defaultChoice": "npm"
+        }
+      }
+    }
+  ]
+}
+```
+
 ## 依赖
 
 ### npm 依赖
@@ -53,4 +128,3 @@ openclaw plugins install ./gewe-openclaw.tgz
 - GeWe API 服务
 - Webhook 回调需要公网可达（可配合 FRP）
 - 媒体对外地址（`mediaPublicUrl`）
-

package/index.ts

@@ -5,7 +5,7 @@ import { gewePlugin } from "./src/channel.js";
 import { setGeweRuntime } from "./src/runtime.js";
 
 const plugin = {
-  id: "gewe",
+  id: "gewe-openclaw",
   name: "GeWe",
   description: "OpenClaw GeWe channel plugin",
   configSchema: emptyPluginConfigSchema(),

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
-  "id": "gewe",
+  "id": "gewe-openclaw",
   "channels": [
-    "gewe"
+    "gewe-openclaw"
   ],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gewe-openclaw",
-  "version": "2026.1.29",
+  "version": "2026.1.31",
   "type": "module",
   "description": "OpenClaw GeWe channel plugin",
   "license": "MIT",
@@ -9,17 +9,18 @@
       "./index.ts"
     ],
     "channel": {
-      "id": "gewe",
+      "id": "gewe-openclaw",
       "label": "GeWe",
       "selectionLabel": "WeChat (GeWe)",
       "detailLabel": "WeChat (GeWe)",
-      "docsPath": "/channels/gewe",
-      "docsLabel": "gewe",
+      "docsPath": "/channels/gewe-openclaw",
+      "docsLabel": "gewe-openclaw",
       "blurb": "WeChat channel via GeWe API and webhook callbacks.",
       "aliases": [
+        "gewe-openclaw",
+        "gewe",
         "wechat",
-        "wx",
-        "gewe"
+        "wx"
       ],
       "order": 72,
       "quickstartAllowFrom": true

package/src/accounts.ts

@@ -2,6 +2,7 @@ import { readFileSync } from "node:fs";
 
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk";
 
+import { CHANNEL_CONFIG_KEY } from "./constants.js";
 import type { CoreConfig, GeweAccountConfig, GeweAppIdSource, GeweTokenSource } from "./types.js";
 
 const DEFAULT_API_BASE_URL = "http://api.geweapi.com";
@@ -18,7 +19,7 @@ export type ResolvedGeweAccount = {
 };
 
 function listConfiguredAccountIds(cfg: CoreConfig): string[] {
-  const accounts = cfg.channels?.gewe?.accounts;
+  const accounts = cfg.channels?.[CHANNEL_CONFIG_KEY]?.accounts;
   if (!accounts || typeof accounts !== "object") return [];
   const ids = new Set<string>();
   for (const key of Object.keys(accounts)) {
@@ -41,7 +42,7 @@ export function resolveDefaultGeweAccountId(cfg: CoreConfig): string {
 }
 
 function resolveAccountConfig(cfg: CoreConfig, accountId: string): GeweAccountConfig | undefined {
-  const accounts = cfg.channels?.gewe?.accounts;
+  const accounts = cfg.channels?.[CHANNEL_CONFIG_KEY]?.accounts;
   if (!accounts || typeof accounts !== "object") return undefined;
   const direct = accounts[accountId] as GeweAccountConfig | undefined;
   if (direct) return direct;
@@ -51,7 +52,7 @@ function resolveAccountConfig(cfg: CoreConfig, accountId: string): GeweAccountCo
 }
 
 function mergeGeweAccountConfig(cfg: CoreConfig, accountId: string): GeweAccountConfig {
-  const { accounts: _ignored, ...base } = (cfg.channels?.gewe ?? {}) as GeweAccountConfig & {
+  const { accounts: _ignored, ...base } = (cfg.channels?.[CHANNEL_CONFIG_KEY] ?? {}) as GeweAccountConfig & {
     accounts?: unknown;
   };
   const account = resolveAccountConfig(cfg, accountId) ?? {};
@@ -117,7 +118,7 @@ export function resolveGeweAccount(params: {
   accountId?: string | null;
 }): ResolvedGeweAccount {
   const hasExplicitAccountId = Boolean(params.accountId?.trim());
-  const baseEnabled = params.cfg.channels?.gewe?.enabled !== false;
+  const baseEnabled = params.cfg.channels?.[CHANNEL_CONFIG_KEY]?.enabled !== false;
 
   const resolve = (accountId: string): ResolvedGeweAccount => {
     const merged = mergeGeweAccountConfig(params.cfg, accountId);
@@ -161,4 +162,3 @@ export function listEnabledGeweAccounts(cfg: CoreConfig): ResolvedGeweAccount[]
     .map((accountId) => resolveGeweAccount({ cfg, accountId }))
     .filter((account) => account.enabled);
 }
-

package/src/channel.ts

@@ -15,6 +15,14 @@ import {
 
 import { resolveGeweAccount, resolveDefaultGeweAccountId, listGeweAccountIds } from "./accounts.js";
 import { GeweConfigSchema } from "./config-schema.js";
+import {
+  CHANNEL_ALIASES,
+  CHANNEL_CONFIG_KEY,
+  CHANNEL_DOCS_LABEL,
+  CHANNEL_DOCS_PATH,
+  CHANNEL_ID,
+  stripChannelPrefix,
+} from "./constants.js";
 import { deliverGewePayload } from "./delivery.js";
 import { monitorGeweProvider } from "./monitor.js";
 import { looksLikeGeweTargetId, normalizeGeweMessagingTarget } from "./normalize.js";
@@ -24,14 +32,14 @@ import { sendTextGewe } from "./send.js";
 import type { CoreConfig, ResolvedGeweAccount } from "./types.js";
 
 const meta = {
-  id: "gewe",
+  id: CHANNEL_ID,
   label: "GeWe",
   selectionLabel: "WeChat (GeWe)",
   detailLabel: "WeChat (GeWe)",
-  docsPath: "/channels/gewe",
-  docsLabel: "gewe",
+  docsPath: CHANNEL_DOCS_PATH,
+  docsLabel: CHANNEL_DOCS_LABEL,
   blurb: "WeChat channel via GeWe API and webhook callbacks.",
-  aliases: ["wechat", "wx", "gewe"],
+  aliases: [...CHANNEL_ALIASES],
   order: 72,
   quickstartAllowFrom: true,
 };
@@ -45,11 +53,11 @@ type GeweSetupInput = ChannelSetupInput & {
 };
 
 export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
-  id: "gewe",
+  id: CHANNEL_ID,
   meta,
   pairing: {
     idLabel: "wechatUserId",
-    normalizeAllowEntry: (entry) => entry.replace(/^(gewe|wechat|wx):/i, ""),
+    normalizeAllowEntry: (entry) => stripChannelPrefix(entry),
     notifyApproval: async ({ cfg, id }) => {
       const account = resolveGeweAccount({ cfg: cfg as CoreConfig });
       if (!account.token || !account.appId) {
@@ -70,7 +78,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
     nativeCommands: false,
     blockStreaming: true,
   },
-  reload: { configPrefixes: ["channels.gewe"] },
+  reload: { configPrefixes: [`channels.${CHANNEL_CONFIG_KEY}`] },
   configSchema: buildChannelConfigSchema(GeweConfigSchema),
   config: {
     listAccountIds: (cfg) => listGeweAccountIds(cfg as CoreConfig),
@@ -79,7 +87,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
     setAccountEnabled: ({ cfg, accountId, enabled }) =>
       setAccountEnabledInConfigSection({
         cfg,
-        sectionKey: "gewe",
+        sectionKey: CHANNEL_CONFIG_KEY,
         accountId,
         enabled,
         allowTopLevel: true,
@@ -87,7 +95,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
     deleteAccount: ({ cfg, accountId }) =>
       deleteAccountFromConfigSection({
         cfg,
-        sectionKey: "gewe",
+        sectionKey: CHANNEL_CONFIG_KEY,
         accountId,
         clearBaseFields: ["token", "tokenFile", "appId", "appIdFile", "name"],
       }),
@@ -108,24 +116,24 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
       allowFrom
         .map((entry) => String(entry).trim())
         .filter(Boolean)
-        .map((entry) => entry.replace(/^(gewe|wechat|wx):/i, "")),
+        .map((entry) => stripChannelPrefix(entry)),
   },
   security: {
     resolveDmPolicy: ({ cfg, accountId, account }) => {
       const resolvedAccountId = accountId ?? account.accountId ?? DEFAULT_ACCOUNT_ID;
       const useAccountPath = Boolean(
-        cfg.channels?.gewe?.accounts?.[resolvedAccountId],
+        cfg.channels?.[CHANNEL_CONFIG_KEY]?.accounts?.[resolvedAccountId],
       );
       const basePath = useAccountPath
-        ? `channels.gewe.accounts.${resolvedAccountId}.`
-        : "channels.gewe.";
+        ? `channels.${CHANNEL_CONFIG_KEY}.accounts.${resolvedAccountId}.`
+        : `channels.${CHANNEL_CONFIG_KEY}.`;
       return {
         policy: account.config.dmPolicy ?? "pairing",
         allowFrom: account.config.allowFrom ?? [],
         policyPath: `${basePath}dmPolicy`,
         allowFromPath: basePath,
-        approveHint: formatPairingApproveHint("gewe"),
-        normalizeEntry: (raw) => raw.replace(/^(gewe|wechat|wx):/i, ""),
+        approveHint: formatPairingApproveHint(CHANNEL_ID),
+        normalizeEntry: (raw) => stripChannelPrefix(raw),
       };
     },
     collectWarnings: ({ account, cfg }) => {
@@ -136,11 +144,11 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
         account.config.groups && Object.keys(account.config.groups).length > 0;
       if (groupAllowlistConfigured) {
         return [
-          `- GeWe groups: groupPolicy="open" allows any member in allowed groups to trigger (mention-gated). Set channels.gewe.groupPolicy="allowlist" + channels.gewe.groupAllowFrom to restrict senders.`,
+          `- GeWe groups: groupPolicy="open" allows any member in allowed groups to trigger (mention-gated). Set channels.${CHANNEL_CONFIG_KEY}.groupPolicy="allowlist" + channels.${CHANNEL_CONFIG_KEY}.groupAllowFrom to restrict senders.`,
         ];
       }
       return [
-        `- GeWe groups: groupPolicy="open" with no channels.gewe.groups allowlist; any group can add + ping (mention-gated). Set channels.gewe.groupPolicy="allowlist" + channels.gewe.groupAllowFrom or configure channels.gewe.groups.`,
+        `- GeWe groups: groupPolicy="open" with no channels.${CHANNEL_CONFIG_KEY}.groups allowlist; any group can add + ping (mention-gated). Set channels.${CHANNEL_CONFIG_KEY}.groupPolicy="allowlist" + channels.${CHANNEL_CONFIG_KEY}.groupAllowFrom or configure channels.${CHANNEL_CONFIG_KEY}.groups.`,
       ];
     },
   },
@@ -187,7 +195,10 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
           }
           return {
             ok: false,
-            error: missingTargetError("GeWe", "<wxid|@chatroom> or channels.gewe.allowFrom[0]"),
+            error: missingTargetError(
+              "GeWe",
+              `<wxid|@chatroom> or channels.${CHANNEL_CONFIG_KEY}.allowFrom[0]`,
+            ),
           };
         }
         return { ok: true, to: normalized };
@@ -198,7 +209,10 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
       }
       return {
         ok: false,
-        error: missingTargetError("GeWe", "<wxid|@chatroom> or channels.gewe.allowFrom[0]"),
+        error: missingTargetError(
+          "GeWe",
+          `<wxid|@chatroom> or channels.${CHANNEL_CONFIG_KEY}.allowFrom[0]`,
+        ),
       };
     },
     sendPayload: async ({ payload, cfg, to, accountId }) => {
@@ -210,7 +224,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
         toWxid: to,
       });
       return {
-        channel: "gewe",
+        channel: CHANNEL_ID,
         messageId: result?.messageId ?? "ok",
         timestamp: result?.timestamp,
         meta: { newMessageId: result?.newMessageId },
@@ -225,7 +239,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
         toWxid: to,
       });
       return {
-        channel: "gewe",
+        channel: CHANNEL_ID,
         messageId: result?.messageId ?? "ok",
         timestamp: result?.timestamp,
         meta: { newMessageId: result?.newMessageId },
@@ -240,7 +254,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
         toWxid: to,
       });
       return {
-        channel: "gewe",
+        channel: CHANNEL_ID,
         messageId: result?.messageId ?? "ok",
         timestamp: result?.timestamp,
         meta: { newMessageId: result?.newMessageId },
@@ -307,7 +321,9 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
     },
     logoutAccount: async ({ accountId, cfg }) => {
       const nextCfg = { ...cfg } as OpenClawConfig;
-      const nextSection = cfg.channels?.gewe ? { ...cfg.channels.gewe } : undefined;
+      const nextSection = cfg.channels?.[CHANNEL_CONFIG_KEY]
+        ? { ...(cfg.channels?.[CHANNEL_CONFIG_KEY] as Record<string, unknown>) }
+        : undefined;
       let cleared = false;
       let changed = false;
 
@@ -377,7 +393,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
         if (changed) {
           nextCfg.channels = {
             ...nextCfg.channels,
-            gewe: nextSection,
+            [CHANNEL_CONFIG_KEY]: nextSection,
           };
         }
       }
@@ -390,7 +406,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
     applyAccountName: ({ cfg, accountId, name }) =>
       applyAccountNameToChannelSection({
         cfg: cfg as OpenClawConfig,
-        channelKey: "gewe",
+        channelKey: CHANNEL_CONFIG_KEY,
         accountId,
         name,
       }),
@@ -411,11 +427,14 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
       const setupInput = input as GeweSetupInput;
       const namedConfig = applyAccountNameToChannelSection({
         cfg: cfg as OpenClawConfig,
-        channelKey: "gewe",
+        channelKey: CHANNEL_CONFIG_KEY,
         accountId,
         name: setupInput.name,
       });
-      const section = (namedConfig.channels?.gewe ?? {}) as Record<string, unknown>;
+      const section = (namedConfig.channels?.[CHANNEL_CONFIG_KEY] ?? {}) as Record<
+        string,
+        unknown
+      >;
       const useAccountPath = accountId !== DEFAULT_ACCOUNT_ID;
       const base = useAccountPath
         ? (section.accounts?.[accountId] as Record<string, unknown> | undefined) ?? {}
@@ -443,7 +462,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
           ...namedConfig,
           channels: {
             ...namedConfig.channels,
-            gewe: nextEntry,
+            [CHANNEL_CONFIG_KEY]: nextEntry,
           },
         };
       }
@@ -451,7 +470,7 @@ export const gewePlugin: ChannelPlugin<ResolvedGeweAccount> = {
         ...namedConfig,
         channels: {
           ...namedConfig.channels,
-          gewe: {
+          [CHANNEL_CONFIG_KEY]: {
             ...section,
             accounts: {
               ...(section.accounts as Record<string, unknown> | undefined),

package/src/config-schema.ts

@@ -81,25 +81,27 @@ export const GeweAccountSchemaBase = z
   });
 
 export const GeweAccountSchema = GeweAccountSchemaBase.superRefine((value, ctx) => {
+  const pathHint = "channels.gewe-openclaw";
   requireOpenAllowFrom({
     policy: value.dmPolicy,
     allowFrom: value.allowFrom,
     ctx,
     path: ["allowFrom"],
     message:
-      'channels.gewe.dmPolicy="open" requires channels.gewe.allowFrom to include "*"',
+      `${pathHint}.dmPolicy="open" requires ${pathHint}.allowFrom to include "*"`,
   });
 });
 
 export const GeweConfigSchema = GeweAccountSchemaBase.extend({
   accounts: z.record(z.string(), GeweAccountSchema.optional()).optional(),
 }).superRefine((value, ctx) => {
+  const pathHint = "channels.gewe-openclaw";
   requireOpenAllowFrom({
     policy: value.dmPolicy,
     allowFrom: value.allowFrom,
     ctx,
     path: ["allowFrom"],
     message:
-      'channels.gewe.dmPolicy="open" requires channels.gewe.allowFrom to include "*"',
+      `${pathHint}.dmPolicy="open" requires ${pathHint}.allowFrom to include "*"`,
   });
 });

package/src/constants.ts

@@ -0,0 +1,10 @@
+export const CHANNEL_ID = "gewe-openclaw" as const;
+export const CHANNEL_CONFIG_KEY = "gewe-openclaw" as const;
+export const CHANNEL_DOCS_PATH = "/channels/gewe-openclaw" as const;
+export const CHANNEL_DOCS_LABEL = "gewe-openclaw" as const;
+export const CHANNEL_PREFIX_REGEX = /^(gewe-openclaw|gewe|wechat|wx):/i;
+export const CHANNEL_ALIASES = ["gewe-openclaw", "gewe", "wechat", "wx"] as const;
+
+export function stripChannelPrefix(value: string): string {
+  return value.replace(CHANNEL_PREFIX_REGEX, "");
+}

package/src/delivery.ts

@@ -5,6 +5,7 @@ import { fileURLToPath } from "node:url";
 
 import type { OpenClawConfig, ReplyPayload } from "openclaw/plugin-sdk";
 import { extractOriginalFilename, extensionForMime } from "openclaw/plugin-sdk";
+import { CHANNEL_ID } from "./constants.js";
 import { getGeweRuntime } from "./runtime.js";
 import {
   sendFileGewe,
@@ -97,8 +98,10 @@ function resolveMediaMaxBytes(account: ResolvedGeweAccount): number {
 }
 
 function resolveGeweData(payload: ReplyPayload): GeweChannelData | undefined {
-  const data = payload.channelData as { gewe?: GeweChannelData } | undefined;
-  return data?.gewe;
+  const data = payload.channelData as
+    | { "gewe-openclaw"?: GeweChannelData; gewe?: GeweChannelData }
+    | undefined;
+  return data?.[CHANNEL_ID] ?? data?.gewe;
 }
 
 function isSilkAudio(opts: { contentType?: string; fileName?: string }): boolean {
@@ -145,7 +148,7 @@ async function probeVideoDurationSeconds(params: {
   sourcePath: string;
 }): Promise<number | null> {
   const core = getGeweRuntime();
-  const logger = core.logging.getChildLogger({ channel: "gewe", module: "video" });
+  const logger = core.logging.getChildLogger({ channel: CHANNEL_ID, module: "video" });
   const ffmpegPath = resolveVideoFfmpegPath(params.account);
   const ffprobePath = resolveVideoFfprobePath(params.account, ffmpegPath);
   const args = [
@@ -180,7 +183,7 @@ async function generateVideoThumbBuffer(params: {
   sourcePath: string;
 }): Promise<Buffer | null> {
   const core = getGeweRuntime();
-  const logger = core.logging.getChildLogger({ channel: "gewe", module: "video" });
+  const logger = core.logging.getChildLogger({ channel: CHANNEL_ID, module: "video" });
   const ffmpegPath = resolveVideoFfmpegPath(params.account);
   const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "moltbot-gewe-video-"));
   const thumbPath = path.join(tmpDir, "thumb.png");
@@ -247,7 +250,7 @@ async function convertAudioToSilk(params: {
   sourcePath: string;
 }): Promise<{ buffer: Buffer; durationMs: number } | null> {
   const core = getGeweRuntime();
-  const logger = core.logging.getChildLogger({ channel: "gewe", module: "voice" });
+  const logger = core.logging.getChildLogger({ channel: CHANNEL_ID, module: "voice" });
   if (!params.account.config.voiceAutoConvert) return null;
 
   const sampleRate = resolveVoiceSampleRate(params.account);
@@ -441,7 +444,7 @@ async function resolveLinkThumbUrl(params: {
   thumbUrl?: string;
 }): Promise<string> {
   const core = getGeweRuntime();
-  const logger = core.logging.getChildLogger({ channel: "gewe", module: "thumb" });
+  const logger = core.logging.getChildLogger({ channel: CHANNEL_ID, module: "thumb" });
   const fallbackBuffer = await fs.readFile(DEFAULT_LINK_THUMB_PATH);
   const fallbackUrl = await stageThumbBuffer({
     account: params.account,
@@ -591,7 +594,7 @@ export async function deliverGewePayload(params: {
       thumbUrl,
     });
     core.channel.activity.record({
-      channel: "gewe",
+      channel: CHANNEL_ID,
       accountId: account.accountId,
       direction: "outbound",
     });
@@ -625,7 +628,7 @@ export async function deliverGewePayload(params: {
             voiceDuration: declaredDuration,
           });
           core.channel.activity.record({
-            channel: "gewe",
+            channel: CHANNEL_ID,
             accountId: account.accountId,
             direction: "outbound",
           });
@@ -657,7 +660,7 @@ export async function deliverGewePayload(params: {
             voiceDuration,
           });
           core.channel.activity.record({
-            channel: "gewe",
+            channel: CHANNEL_ID,
             accountId: account.accountId,
             direction: "outbound",
           });
@@ -674,7 +677,7 @@ export async function deliverGewePayload(params: {
         imgUrl: staged.publicUrl,
       });
       core.channel.activity.record({
-        channel: "gewe",
+        channel: CHANNEL_ID,
         accountId: account.accountId,
         direction: "outbound",
       });
@@ -683,7 +686,7 @@ export async function deliverGewePayload(params: {
     }
 
     if (!forceFile && kind === "video") {
-      const logger = core.logging.getChildLogger({ channel: "gewe", module: "video" });
+      const logger = core.logging.getChildLogger({ channel: CHANNEL_ID, module: "video" });
       const video = geweData?.video;
       let thumbUrl = video?.thumbUrl;
       const fallbackThumbUrl = account.config.videoThumbUrl?.trim() || undefined;
@@ -755,7 +758,7 @@ export async function deliverGewePayload(params: {
             videoDuration: Math.floor(videoDuration),
           });
           core.channel.activity.record({
-            channel: "gewe",
+            channel: CHANNEL_ID,
             accountId: account.accountId,
             direction: "outbound",
           });
@@ -780,7 +783,7 @@ export async function deliverGewePayload(params: {
               videoDuration: Math.floor(videoDuration),
             });
             core.channel.activity.record({
-              channel: "gewe",
+              channel: CHANNEL_ID,
               accountId: account.accountId,
               direction: "outbound",
             });
@@ -803,7 +806,7 @@ export async function deliverGewePayload(params: {
       fileName: fallbackName,
     });
     core.channel.activity.record({
-      channel: "gewe",
+      channel: CHANNEL_ID,
       accountId: account.accountId,
       direction: "outbound",
     });
@@ -814,7 +817,7 @@ export async function deliverGewePayload(params: {
   if (trimmedText) {
     const tableMode = core.channel.text.resolveMarkdownTableMode({
       cfg,
-      channel: "gewe",
+      channel: CHANNEL_ID,
       accountId: account.accountId,
     });
     const content = core.channel.text.convertMarkdownTables(trimmedText, tableMode);
@@ -825,7 +828,7 @@ export async function deliverGewePayload(params: {
       ats: geweData?.ats,
     });
     core.channel.activity.record({
-      channel: "gewe",
+      channel: CHANNEL_ID,
       accountId: account.accountId,
       direction: "outbound",
     });

package/src/inbound.ts

@@ -19,8 +19,7 @@ import {
 } from "./policy.js";
 import type { CoreConfig, GeweInboundMessage, ResolvedGeweAccount } from "./types.js";
 import { extractAppMsgType, extractFileName, extractLinkDetails } from "./xml.js";
-
-const CHANNEL_ID = "gewe" as const;
+import { CHANNEL_ID } from "./constants.js";
 
 type PreparedInbound = {
   rawBody: string;
@@ -103,7 +102,7 @@ async function decodeSilkVoice(params: {
   fileName?: string | null;
 }): Promise<DecodedVoice | null> {
   const core = getGeweRuntime();
-  const logger = core.logging.getChildLogger({ channel: "gewe", module: "voice" });
+  const logger = core.logging.getChildLogger({ channel: CHANNEL_ID, module: "voice" });
   const decodeOutput = params.account.config.voiceDecodeOutput ?? "pcm";
   const sampleRate = resolveVoiceDecodeSampleRate(params.account);
   const ffmpegPath = params.account.config.voiceFfmpegPath?.trim() || "ffmpeg";
@@ -261,8 +260,10 @@ async function dispatchGeweInbound(params: {
     Body: body,
     RawBody: prepared.rawBody,
     CommandBody: prepared.rawBody,
-    From: prepared.groupId ? `gewe:group:${prepared.groupId}` : `gewe:${prepared.senderId}`,
-    To: `gewe:${prepared.toWxid}`,
+    From: prepared.groupId
+      ? `${CHANNEL_ID}:group:${prepared.groupId}`
+      : `${CHANNEL_ID}:${prepared.senderId}`,
+    To: `${CHANNEL_ID}:${prepared.toWxid}`,
     SessionKey: prepared.route.sessionKey,
     AccountId: prepared.route.accountId,
     ChatType: prepared.isGroup ? "group" : "direct",
@@ -272,16 +273,16 @@ async function dispatchGeweInbound(params: {
     SenderName: prepared.senderName || undefined,
     SenderId: prepared.senderId,
     CommandAuthorized: prepared.commandAuthorized,
-    Provider: "gewe",
-    Surface: "gewe",
+    Provider: CHANNEL_ID,
+    Surface: CHANNEL_ID,
     MessageSid: prepared.messageSid,
     MessageSidFull: prepared.messageSid,
     MediaPath: media?.path,
     MediaType: media?.contentType,
     MediaUrl: media?.path,
     GroupSystemPrompt: prepared.groupSystemPrompt,
-    OriginatingChannel: "gewe",
-    OriginatingTo: `gewe:${prepared.toWxid}`,
+    OriginatingChannel: CHANNEL_ID,
+    OriginatingTo: `${CHANNEL_ID}:${prepared.toWxid}`,
   });
 
   await core.channel.session.recordInboundSession({
@@ -523,7 +524,7 @@ export async function handleGeweInbound(params: {
   };
 
   core.channel.activity.record({
-    channel: "gewe",
+    channel: CHANNEL_ID,
     accountId: account.accountId,
     direction: "inbound",
   });

package/src/normalize.ts

@@ -1,17 +1,16 @@
 export function normalizeGeweMessagingTarget(target: string): string | null {
   const trimmed = target.trim();
   if (!trimmed) return null;
+  const prefix = /^(gewe-openclaw|gewe|wechat|wx):(group:|user:)?/i;
   return trimmed
-    .replace(/^gewe:(group:|user:)?/i, "")
-    .replace(/^wechat:(group:|user:)?/i, "")
-    .replace(/^wx:/i, "")
+    .replace(prefix, "")
     .trim();
 }
 
 export function looksLikeGeweTargetId(id: string): boolean {
   const trimmed = id?.trim();
   if (!trimmed) return false;
-  if (/^gewe:/i.test(trimmed)) return true;
+  if (/^(gewe-openclaw|gewe):/i.test(trimmed)) return true;
   if (/@chatroom$/i.test(trimmed)) return true;
   if (/^wxid_/i.test(trimmed)) return true;
   if (/^gh_/i.test(trimmed)) return true;

package/src/policy.ts

@@ -7,10 +7,11 @@ import {
   resolveNestedAllowlistDecision,
 } from "openclaw/plugin-sdk";
 
+import { CHANNEL_CONFIG_KEY, CHANNEL_PREFIX_REGEX } from "./constants.js";
 import type { GeweGroupConfig } from "./types.js";
 
 function normalizeAllowEntry(raw: string): string {
-  return raw.trim().toLowerCase().replace(/^(gewe|wechat|wx):/i, "");
+  return raw.trim().toLowerCase().replace(CHANNEL_PREFIX_REGEX, "");
 }
 
 export function normalizeGeweAllowlist(values: Array<string | number> | undefined): string[] {
@@ -89,7 +90,7 @@ export function resolveGeweGroupToolPolicy(
 ): GeweGroupConfig["tools"] | undefined {
   const cfg = params.cfg as {
     channels?: {
-      gewe?: {
+      "gewe-openclaw"?: {
         groups?: Record<string, GeweGroupConfig>;
         accounts?: Record<string, { groups?: Record<string, GeweGroupConfig> }>;
       };
@@ -99,10 +100,10 @@ export function resolveGeweGroupToolPolicy(
   if (!groupId) return undefined;
   const groupName = params.groupChannel?.trim() || undefined;
   const accountGroups =
-    params.accountId && cfg.channels?.gewe?.accounts?.[params.accountId]?.groups
-      ? cfg.channels?.gewe?.accounts?.[params.accountId]?.groups
+    params.accountId && cfg.channels?.[CHANNEL_CONFIG_KEY]?.accounts?.[params.accountId]?.groups
+      ? cfg.channels?.[CHANNEL_CONFIG_KEY]?.accounts?.[params.accountId]?.groups
       : undefined;
-  const groups = accountGroups ?? cfg.channels?.gewe?.groups;
+  const groups = accountGroups ?? cfg.channels?.[CHANNEL_CONFIG_KEY]?.groups;
   const match = resolveGeweGroupMatch({
     groups,
     groupId,

package/src/types.ts

@@ -67,7 +67,7 @@ export type GeweConfig = {
 
 export type CoreConfig = {
   channels?: {
-    gewe?: GeweConfig;
+    "gewe-openclaw"?: GeweConfig;
   };
   [key: string]: unknown;
 };