gewe-openclaw 2026.3.25 → 2026.3.27

package/README.md

@@ -95,7 +95,7 @@ openclaw onboard
 - `s3PublicBaseUrl`：`public` 模式下用于拼接可访问 URL（必填）。
 - `s3PresignExpiresSec`：`presigned` 模式签名有效期（默认 3600 秒）。
 - `s3KeyPrefix`：对象 key 前缀（默认 `gewe-openclaw/outbound`）。
-- `allowFrom`：允许私聊触发的微信 ID（或在群里走 allowlist 规则）。
+- `allowFrom`：允许私聊触发的微信 ID；不再隐式用于群聊权限。
 - `voiceAutoConvert`：自动将音频转为 silk（默认开启；设为 `false` 可关闭）。
 - `silkAutoDownload`：自动下载 `rust-silk`（默认开启；可关闭后自行配置 `voiceSilkPath` / `voiceDecodePath`）。
 - `silkVersion`：自动下载的 `rust-silk` 版本（`latest` 会自动清理旧版本）。
@@ -238,6 +238,11 @@ GeWe 现在补齐了目录、标准 allowlist 适配和状态摘要。
 - 私聊：`allowFrom`
 - 群发言人：`groupAllowFrom`
 
+注意：
+
+- 私聊 `pairing` 只会把对方加入私聊 allowlist，不会自动给任何群开权限。
+- 群聊权限只看 `groupAllowFrom` 和 `groups.<groupId>.allowFrom`。
+
 如果你要管理“某一个群自己的 `groups.<groupId>.allowFrom` 覆盖”，请用插件工具：
 
 - `gewe_manage_group_allowlist`
@@ -260,6 +265,75 @@ GeWe 现在补齐了目录、标准 allowlist 适配和状态摘要。
 }
 ```
 
+### 认证方式
+
+如果你是第一次用，可以把它理解成两步：
+
+1. 先在私聊里完成配对
+2. 再在要使用的群里完成认领
+
+为什么要分成两步：
+
+- 私聊配对成功，只表示“你可以在私聊里跟机器人说话了”
+- 这一步不会让机器人自动在所有群里生效
+- 群认领是第二次确认，表示“这个群也允许你使用机器人”
+- 这样做是为了避免机器人一进公开群就被任何人直接触发
+
+你实际要做的事很简单：
+
+1. 先和机器人私聊，完成配对
+2. 再在私聊里让机器人给你一个 8 位认领码
+3. 把机器人拉进目标群
+4. 在目标群里直接发这 8 位认领码
+5. 收到成功提示后，这个群就接入完成了
+
+举个例子：
+
+- 机器人在私聊里给你：`MJSQ2G9H`
+- 你把机器人拉进目标群
+- 你在群里直接发：`MJSQ2G9H`
+
+几个容易搞混的点：
+
+- 群里不需要 `@机器人`
+- 最推荐的发法就是只发这 8 位码
+- `认领码: MJSQ2G9H` 这种写法也能识别，但默认不推荐
+- 认领码有时效，而且只能用一次
+- 这个码是谁拿到的，就只能由谁来完成这次认领
+
+认领成功后会发生什么：
+
+- 机器人会记住“你可以在这个群里使用它了”
+- 只影响当前这个群
+- 不会顺手把别的群也打开
+- 不会自动帮你创建额外的绑定配置
+
+如果你会自己改配置文件：
+
+- 认领成功后，插件会把当前发码者写入 `groups.<groupId>.allowFrom`
+
+### 群认领
+
+如果是一个还没放行的新群，推荐流程是：
+
+1. 先在已配对的私聊里调用 `gewe_issue_group_claim_code`
+2. 把机器人拉进目标群
+3. 在目标群里只发送这 8 位认领码：`XXXXXXXX`
+
+推荐默认话术：
+
+- 私聊里直接把 8 位码发给用户，不要包装成 `认领码: XXXXXXXX`
+- 群里也只发这 8 位码，不要加 `认领码:` 前缀
+
+认领成功后，插件会把“当前发码者”写入该群的 `groups.<groupId>.allowFrom`。
+
+默认特性：
+
+- 认领码短时有效、单次使用
+- 只能由签发它的那个发码者在群里使用
+- 只给当前群开权限，不会改顶层 `groupAllowFrom`
+- 不会自动创建 `bindings[]`
+
 如果你就在目标群里调用，`groupId` 可以省略；工具会自动用当前群。
 
 ### 状态

package/index.ts

@@ -1,11 +1,17 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpenClawPluginApi } from "./src/openclaw-compat.js";
 
 import { createGeweApiTools } from "./src/api-tools.js";
 import { gewePlugin } from "./src/channel.js";
 import { createGeweManageGroupAllowlistTool } from "./src/group-allowlist-tool.js";
 import { createGeweSyncGroupBindingTool } from "./src/group-binding-tool.js";
+import { createGeweIssueGroupClaimCodeTool } from "./src/group-claim-tool.js";
 import { setGeweRuntime } from "./src/runtime.js";
 
+type CompatRegistrationMode = "full" | "setup-only" | "setup-runtime";
+type CompatOpenClawPluginApi = OpenClawPluginApi & {
+  registrationMode?: CompatRegistrationMode;
+};
+
 function emptyPluginConfigSchema() {
   return {
     safeParse(value: unknown) {
@@ -40,10 +46,18 @@ const plugin = {
   description: "OpenClaw GeWe channel plugin",
   configSchema: emptyPluginConfigSchema(),
   register(api: OpenClawPluginApi) {
+    const compatApi = api as CompatOpenClawPluginApi;
+
     setGeweRuntime(api.runtime);
     api.registerChannel({ plugin: gewePlugin });
+
+    if (compatApi.registrationMode && compatApi.registrationMode !== "full") {
+      return;
+    }
+
     api.registerTool((ctx) => createGeweApiTools(ctx));
     api.registerTool((ctx) => createGeweSyncGroupBindingTool(ctx));
+    api.registerTool((ctx) => createGeweIssueGroupClaimCodeTool(ctx));
     api.registerTool((ctx) =>
       createGeweManageGroupAllowlistTool(ctx, {
         readConfig: () => api.runtime.config.loadConfig() as never,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gewe-openclaw",
-  "version": "2026.3.25",
+  "version": "2026.3.27",
   "type": "module",
   "description": "OpenClaw GeWe channel plugin",
   "license": "MIT",
@@ -10,6 +10,7 @@
   },
   "files": [
     "index.ts",
+    "setup-entry.ts",
     "openclaw.plugin.json",
     "assets/gewe-rs_logo.jpeg",
     "skills/**",
@@ -20,6 +21,7 @@
     "extensions": [
       "./index.ts"
     ],
+    "setupEntry": "./setup-entry.ts",
     "channel": {
       "id": "gewe-openclaw",
       "label": "GeWe",

package/setup-entry.ts

@@ -0,0 +1,9 @@
+import { geweSetupPlugin } from "./src/channel.setup.js";
+
+export { geweSetupPlugin } from "./src/channel.setup.js";
+
+// Keep the setup entry as a plain `{ plugin }` export so newer OpenClaw can
+// load the channel surface without requiring newer runtime helpers at import time.
+export default {
+  plugin: geweSetupPlugin,
+};

package/skills/gewe-agent-tools/SKILL.md

@@ -14,12 +14,13 @@ metadata:
 
 # GeWe Agent Tools
 
-优先把这四个工具当成 GeWe 的正式操作面：
+优先把这五个工具当成 GeWe 的正式操作面：
 
 - `gewe_contacts`
 - `gewe_groups`
 - `gewe_moments`
 - `gewe_personal`
+- `gewe_issue_group_claim_code`
 
 ## 什么时候用哪个
 
@@ -27,10 +28,48 @@ metadata:
 - 处理群资料、群成员、群公告、群管理：用 `gewe_groups`
 - 处理朋友圈浏览、点赞、评论、发布、转发：用 `gewe_moments`
 - 处理当前登录微信自己的资料、二维码、安全信息、隐私设置：用 `gewe_personal`
+- 处理新群接入、给当前已配对私聊签发群认领码：用 `gewe_issue_group_claim_code`
 
 如果只是想知道“现在这个私聊对象是谁”，优先用 `gewe_contacts`。
 如果只是想知道“现在这个群是谁、有哪些成员”，优先用 `gewe_groups`。
 
+## 新群接入
+
+当用户在 GeWe 当前私聊会话里表达这些意思时，优先进入“群认领”流程，而不是旧的手工绑群流程：
+
+- “我要新绑定一个群”
+- “给这个新群开权限”
+- “把机器人接入一个新群”
+
+这时优先调用 `gewe_issue_group_claim_code`。
+
+关键原则：
+
+- 不要先让用户手填群 id
+- 不要先让用户自己改配置
+- 不要把“私聊已经 pairing 成功”理解成“群已经自动放行”
+
+标准动作：
+
+1. 在当前私聊会话里调用 `gewe_issue_group_claim_code`
+2. 把返回的 8 位认领码原样发给用户
+3. 明确告诉用户：先把机器人拉进目标新群
+4. 再让用户在目标群里只发送这 8 位认领码，例如：`XXXXXXXX`
+
+重要话术约束：
+
+- 默认只把 8 位码发给用户，不要包装成 `认领码: XXXXXXXX`
+- 默认明确提醒：群里也只发这 8 位码，不要加 `认领码:` 前缀
+
+推荐话术要点：
+
+- 这是短时有效、单次使用的认领码
+- 认领成功后，只会授权当前发码者在这个新群里触发机器人
+- 如果只是想查新群资料，再在当前群会话里用 `gewe_groups`
+
+只有在用户已经明确处在目标群里，且需求是“查当前群信息 / 查成员 / 查群 id”时，才优先使用 `gewe_groups`。
+如果需求是“接入一个还没放行的新群”，先发认领码，再谈群信息。
+
 ## 当前会话推断
 
 有些 action 可以少填参数，优先利用当前会话：

package/src/api-tools.ts

@@ -1,4 +1,3 @@
-import type { AnyAgentTool, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
 import { z } from "zod";
 
 import { resolveGeweAccount } from "./accounts.js";
@@ -65,7 +64,13 @@ import {
   uploadSnsVideoGewe,
 } from "./moments-api.js";
 import { normalizeGeweMessagingTarget } from "./normalize.js";
-import { normalizeAccountId, type OpenClawConfig } from "./openclaw-compat.js";
+import {
+  buildJsonSchema,
+  normalizeAccountId,
+  type AnyAgentTool,
+  type OpenClawConfig,
+  type OpenClawPluginToolContext,
+} from "./openclaw-compat.js";
 import {
   getProfileGewe,
   getQrCodeGewe,
@@ -74,6 +79,7 @@ import {
   updateHeadImgGewe,
   updateProfileGewe,
 } from "./personal-api.js";
+import { shouldExposeGeweAgentTool } from "./tool-visibility.js";
 import type { CoreConfig, ResolvedGeweAccount } from "./types.js";
 
 const ContactsActionSchema = z.enum([
@@ -243,6 +249,11 @@ const PersonalToolSchema = z
   })
   .strict();
 
+const ContactsToolParameters = buildJsonSchema(ContactsToolSchema) ?? { type: "object" };
+const GroupsToolParameters = buildJsonSchema(GroupsToolSchema) ?? { type: "object" };
+const MomentsToolParameters = buildJsonSchema(MomentsToolSchema) ?? { type: "object" };
+const PersonalToolParameters = buildJsonSchema(PersonalToolSchema) ?? { type: "object" };
+
 type ContactsToolParams = z.infer<typeof ContactsToolSchema>;
 type GroupsToolParams = z.infer<typeof GroupsToolSchema>;
 type MomentsToolParams = z.infer<typeof MomentsToolSchema>;
@@ -1150,15 +1161,17 @@ async function executePersonalTool(
   }
 }
 
-export function createGeweApiTools(ctx: OpenClawPluginToolContext): AnyAgentTool[] {
+export function createGeweApiTools(ctx: OpenClawPluginToolContext): AnyAgentTool[] | null {
+  if (!shouldExposeGeweAgentTool(ctx)) {
+    return null;
+  }
   return [
     {
       name: "gewe_contacts",
       label: "GeWe Contacts",
       description:
         "GeWe contacts operations. Actions: list, list_cache, brief, detail, search, search_im, im_detail, check_relation, set_remark, set_only_chat, delete, add, add_im, sync_im, phones_get, phones_upload.",
-      ownerOnly: true,
-      parameters: ContactsToolSchema,
+      parameters: ContactsToolParameters,
       execute: async (_toolCallId, rawParams) => {
         const params = ContactsToolSchema.parse(rawParams ?? {});
         try {
@@ -1184,8 +1197,7 @@ export function createGeweApiTools(ctx: OpenClawPluginToolContext): AnyAgentTool
       label: "GeWe Groups",
       description:
         "GeWe group operations. Actions: info, announcement, members, member_detail, qr_code, set_self_nickname, rename, set_remark, create, remove_members, agree_join, join_via_qr, add_member_as_friend, approve_join_request, admin_operate, save_to_contacts, pin, disband, set_silence, set_announcement, quit, invite.",
-      ownerOnly: true,
-      parameters: GroupsToolSchema,
+      parameters: GroupsToolParameters,
       execute: async (_toolCallId, rawParams) => {
         const params = GroupsToolSchema.parse(rawParams ?? {});
         try {
@@ -1211,8 +1223,7 @@ export function createGeweApiTools(ctx: OpenClawPluginToolContext): AnyAgentTool
       label: "GeWe Moments",
       description:
         "GeWe Moments operations. Actions: list_self, list_contact, detail, download_video, upload_image, upload_video, delete, post_text, post_image, post_video, post_link, set_stranger_visibility, set_visible_scope, set_privacy, like, comment, forward.",
-      ownerOnly: true,
-      parameters: MomentsToolSchema,
+      parameters: MomentsToolParameters,
       execute: async (_toolCallId, rawParams) => {
         const params = MomentsToolSchema.parse(rawParams ?? {});
         try {
@@ -1238,8 +1249,7 @@ export function createGeweApiTools(ctx: OpenClawPluginToolContext): AnyAgentTool
       label: "GeWe Personal",
       description:
         "GeWe personal-account operations. Actions: profile, qrcode, safety_info, update_profile, update_avatar, privacy.",
-      ownerOnly: true,
-      parameters: PersonalToolSchema,
+      parameters: PersonalToolParameters,
       execute: async (_toolCallId, rawParams) => {
         const params = PersonalToolSchema.parse(rawParams ?? {});
         try {

package/src/channel-actions.ts

@@ -3,7 +3,7 @@ import type {
   ChannelMessageActionAdapter,
   ChannelMessageActionName,
   ChannelMessageToolSchemaContribution,
-} from "openclaw/plugin-sdk/channel-runtime";
+} from "./openclaw-compat.js";
 
 import { listEnabledGeweAccounts, resolveGeweAccount } from "./accounts.js";
 import { deliverGewePayload } from "./delivery.js";

package/src/channel-allowlist.ts

@@ -1,11 +1,13 @@
-import type { ChannelAllowlistAdapter } from "openclaw/plugin-sdk/channel-runtime";
-
 import { resolveGeweAccount } from "./accounts.js";
 import { collectKnownGeweGroupEntries } from "./channel-directory.js";
 import { cleanupEmptyObject, ensureGeweWriteSectionInPlace } from "./config-edit.js";
 import { CHANNEL_CONFIG_KEY, stripChannelPrefix } from "./constants.js";
 import { normalizeGeweMessagingTarget } from "./normalize.js";
-import { normalizeAccountId, type OpenClawConfig } from "./openclaw-compat.js";
+import {
+  normalizeAccountId,
+  type ChannelAllowlistAdapter,
+  type OpenClawConfig,
+} from "./openclaw-compat.js";
 import type { CoreConfig } from "./types.js";
 import { resolveCachedGeweName } from "./directory-cache.js";
 

package/src/channel-common.ts

@@ -0,0 +1,184 @@
+import {
+  applyAccountNameToChannelSection,
+  buildChannelConfigSchema,
+  DEFAULT_ACCOUNT_ID,
+  deleteAccountFromConfigSection,
+  normalizeAccountId,
+  setAccountEnabledInConfigSection,
+  type ChannelPlugin,
+  type ChannelSetupInput,
+  type OpenClawConfig,
+} from "./openclaw-compat.js";
+
+import { resolveDefaultGeweAccountId, listGeweAccountIds, resolveGeweAccount } 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 { geweSetupWizard } from "./setup-wizard.js";
+import type { CoreConfig, ResolvedGeweAccount } from "./types.js";
+
+type GeweSetupInput = ChannelSetupInput & {
+  token?: string;
+  tokenFile?: string;
+  appId?: string;
+  appIdFile?: string;
+  apiBaseUrl?: string;
+};
+
+export const geweChannelMeta = {
+  id: CHANNEL_ID,
+  label: "GeWe",
+  selectionLabel: "WeChat (GeWe)",
+  detailLabel: "WeChat (GeWe)",
+  docsPath: CHANNEL_DOCS_PATH,
+  docsLabel: CHANNEL_DOCS_LABEL,
+  blurb: "WeChat channel via GeWe API and webhook callbacks.",
+  aliases: [...CHANNEL_ALIASES],
+  order: 72,
+  quickstartAllowFrom: true,
+} as const;
+
+export const geweSetupAdapter: NonNullable<ChannelPlugin<ResolvedGeweAccount>["setup"]> = {
+  resolveAccountId: ({ accountId }) => normalizeAccountId(accountId),
+  applyAccountName: ({ cfg, accountId, name }) =>
+    applyAccountNameToChannelSection({
+      cfg: cfg as OpenClawConfig,
+      channelKey: CHANNEL_CONFIG_KEY,
+      accountId,
+      name,
+    }),
+  validateInput: ({ accountId, input }) => {
+    const setupInput = input as GeweSetupInput;
+    if (setupInput.useEnv && accountId !== DEFAULT_ACCOUNT_ID) {
+      return "GEWE_TOKEN/GEWE_APP_ID can only be used for the default account.";
+    }
+    if (!setupInput.useEnv && !setupInput.token && !setupInput.tokenFile) {
+      return "GeWe requires --token or --token-file (or --use-env).";
+    }
+    if (!setupInput.useEnv && !setupInput.appId && !setupInput.appIdFile) {
+      return "GeWe requires --app-id or --app-id-file (or --use-env).";
+    }
+    return null;
+  },
+  applyAccountConfig: ({ cfg, accountId, input }) => {
+    const setupInput = input as GeweSetupInput;
+    const namedConfig = applyAccountNameToChannelSection({
+      cfg: cfg as OpenClawConfig,
+      channelKey: CHANNEL_CONFIG_KEY,
+      accountId,
+      name: setupInput.name,
+    });
+    const section = (namedConfig.channels?.[CHANNEL_CONFIG_KEY] ?? {}) as Record<
+      string,
+      unknown
+    > & {
+      accounts?: Record<string, Record<string, unknown>>;
+    };
+    const useAccountPath = accountId !== DEFAULT_ACCOUNT_ID;
+    const base = useAccountPath ? section.accounts?.[accountId] ?? {} : section;
+    const nextEntry = {
+      ...base,
+      ...(setupInput.apiBaseUrl ? { apiBaseUrl: setupInput.apiBaseUrl } : {}),
+      ...(setupInput.useEnv
+        ? {}
+        : setupInput.token
+          ? { token: setupInput.token }
+          : setupInput.tokenFile
+            ? { tokenFile: setupInput.tokenFile }
+            : {}),
+      ...(setupInput.useEnv
+        ? {}
+        : setupInput.appId
+          ? { appId: setupInput.appId }
+          : setupInput.appIdFile
+            ? { appIdFile: setupInput.appIdFile }
+            : {}),
+    };
+    if (!useAccountPath) {
+      return {
+        ...namedConfig,
+        channels: {
+          ...namedConfig.channels,
+          [CHANNEL_CONFIG_KEY]: nextEntry,
+        },
+      };
+    }
+    return {
+      ...namedConfig,
+      channels: {
+        ...namedConfig.channels,
+        [CHANNEL_CONFIG_KEY]: {
+          ...section,
+          accounts: {
+            ...(section.accounts as Record<string, unknown> | undefined),
+            [accountId]: nextEntry,
+          },
+        },
+      },
+    };
+  },
+};
+
+export const geweChannelPluginCommon = {
+  meta: geweChannelMeta,
+  setupWizard: geweSetupWizard,
+  capabilities: {
+    chatTypes: ["direct", "group"],
+    reactions: false,
+    threads: false,
+    media: true,
+    nativeCommands: false,
+    blockStreaming: true,
+  },
+  reload: { configPrefixes: [`channels.${CHANNEL_CONFIG_KEY}`] },
+  configSchema: buildChannelConfigSchema(GeweConfigSchema),
+  config: {
+    listAccountIds: (cfg: OpenClawConfig) => listGeweAccountIds(cfg as CoreConfig),
+    resolveAccount: (cfg: OpenClawConfig, accountId?: string | null) =>
+      resolveGeweAccount({ cfg: cfg as CoreConfig, accountId }),
+    defaultAccountId: (cfg: OpenClawConfig) => resolveDefaultGeweAccountId(cfg as CoreConfig),
+    setAccountEnabled: ({ cfg, accountId, enabled }: { cfg: OpenClawConfig; accountId: string; enabled: boolean }) =>
+      setAccountEnabledInConfigSection({
+        cfg,
+        sectionKey: CHANNEL_CONFIG_KEY,
+        accountId,
+        enabled,
+        allowTopLevel: true,
+      }),
+    deleteAccount: ({ cfg, accountId }: { cfg: OpenClawConfig; accountId: string }) =>
+      deleteAccountFromConfigSection({
+        cfg,
+        sectionKey: CHANNEL_CONFIG_KEY,
+        accountId,
+        clearBaseFields: ["token", "tokenFile", "appId", "appIdFile", "name"],
+      }),
+    isConfigured: (account: ResolvedGeweAccount) => Boolean(account.token?.trim() && account.appId?.trim()),
+    describeAccount: (account: ResolvedGeweAccount) => ({
+      accountId: account.accountId,
+      name: account.name,
+      enabled: account.enabled,
+      configured: Boolean(account.token?.trim() && account.appId?.trim()),
+      tokenSource: account.tokenSource,
+      baseUrl: account.config.apiBaseUrl ? "[set]" : "[missing]",
+    }),
+    resolveAllowFrom: ({ cfg, accountId }: { cfg: OpenClawConfig; accountId?: string | null }) =>
+      (resolveGeweAccount({ cfg: cfg as CoreConfig, accountId }).config.allowFrom ?? []).map(
+        (entry) => String(entry),
+      ),
+    formatAllowFrom: ({ allowFrom }: { allowFrom: Array<string | number> }) =>
+      allowFrom
+        .map((entry) => String(entry).trim())
+        .filter(Boolean)
+        .map((entry) => stripChannelPrefix(entry)),
+  },
+  setup: geweSetupAdapter,
+} satisfies Pick<
+  ChannelPlugin<ResolvedGeweAccount>,
+  "meta" | "setupWizard" | "capabilities" | "reload" | "configSchema" | "config" | "setup"
+>;

package/src/channel-directory.ts

@@ -1,5 +1,3 @@
-import type { ChannelDirectoryAdapter, ChannelDirectoryEntry } from "openclaw/plugin-sdk/channel-runtime";
-
 import { resolveGeweAccount } from "./accounts.js";
 import {
   fetchContactsListCacheGewe,
@@ -14,7 +12,12 @@ import {
   normalizeGeweBindingConversationId,
 } from "./group-binding.js";
 import { normalizeGeweMessagingTarget } from "./normalize.js";
-import { normalizeAccountId, type OpenClawConfig } from "./openclaw-compat.js";
+import {
+  normalizeAccountId,
+  type ChannelDirectoryAdapter,
+  type ChannelDirectoryEntry,
+  type OpenClawConfig,
+} from "./openclaw-compat.js";
 import type { CoreConfig } from "./types.js";
 import {
   listCachedGeweGroups,

package/src/channel-status.ts

@@ -1,12 +1,15 @@
-import type { ChannelStatusAdapter, ChannelStatusIssue } from "openclaw/plugin-sdk/channel-runtime";
-
 import type { ResolvedGeweAccount } from "./accounts.js";
 import { collectKnownGeweGroupEntries, collectKnownGewePeerEntries } from "./channel-directory.js";
 import { getGeweDirectoryCacheCounts } from "./directory-cache.js";
 import { CHANNEL_CONFIG_KEY } from "./constants.js";
 import { getGeweProfile } from "./group-binding.js";
 import { normalizeGeweBindingConversationId } from "./group-binding.js";
-import { normalizeAccountId, type OpenClawConfig } from "./openclaw-compat.js";
+import {
+  normalizeAccountId,
+  type ChannelStatusAdapter,
+  type ChannelStatusIssue,
+  type OpenClawConfig,
+} from "./openclaw-compat.js";
 import { readGeweAllowFromStore } from "./pairing-store.js";
 
 type GeweStatusProbe = {

package/src/channel.setup.ts

@@ -0,0 +1,9 @@
+import { CHANNEL_ID } from "./constants.js";
+import { geweChannelPluginCommon } from "./channel-common.js";
+import type { GeweChannelPlugin } from "./setup-wizard-types.js";
+import type { ResolvedGeweAccount } from "./types.js";
+
+export const geweSetupPlugin: GeweChannelPlugin<ResolvedGeweAccount> = {
+  id: CHANNEL_ID,
+  ...geweChannelPluginCommon,
+};