gewe-openclaw 2026.3.13 → 2026.3.23

package/src/send.ts

@@ -7,6 +7,12 @@ type GeweSendContext = {
   appId: string;
 };
 
+type GeweSendResponseData = {
+  msgId?: number | string;
+  newMsgId?: number | string;
+  createTime?: number | null;
+};
+
 function buildContext(account: ResolvedGeweAccount): GeweSendContext {
   const baseUrl = account.config.apiBaseUrl?.trim() || "https://www.geweapi.com";
   return { baseUrl, token: account.token, appId: account.appId };
@@ -14,13 +20,9 @@ function buildContext(account: ResolvedGeweAccount): GeweSendContext {
 
 function resolveSendResult(params: {
   toWxid: string;
-  data?: {
-    msgId?: number | string;
-    newMsgId?: number | string;
-    createTime?: number | null;
-  };
+  data?: GeweSendResponseData;
 }): GeweSendResult {
-  const msgId = params.data?.newMsgId ?? params.data?.msgId ?? "ok";
+  const msgId = params.data?.msgId ?? params.data?.newMsgId ?? "ok";
   const createTime = params.data?.createTime;
   return {
     toWxid: params.toWxid,
@@ -30,6 +32,30 @@ function resolveSendResult(params: {
   };
 }
 
+async function sendXmlForwardGewe(params: {
+  account: ResolvedGeweAccount;
+  path: string;
+  context: string;
+  toWxid: string;
+  xml: string;
+  extraBody?: Record<string, unknown>;
+}): Promise<GeweSendResult> {
+  const ctx = buildContext(params.account);
+  const resp = await postGeweJson<GeweSendResponseData>({
+    baseUrl: ctx.baseUrl,
+    token: ctx.token,
+    path: params.path,
+    body: {
+      appId: ctx.appId,
+      toWxid: params.toWxid,
+      xml: params.xml,
+      ...(params.extraBody ?? {}),
+    },
+  });
+  const data = assertGeweOk(resp, params.context);
+  return resolveSendResult({ toWxid: params.toWxid, data });
+}
+
 export async function sendTextGewe(params: {
   account: ResolvedGeweAccount;
   toWxid: string;
@@ -37,11 +63,7 @@ export async function sendTextGewe(params: {
   ats?: string;
 }): Promise<GeweSendResult> {
   const ctx = buildContext(params.account);
-  const resp = await postGeweJson<{
-    msgId?: number | string;
-    newMsgId?: number | string;
-    createTime?: number;
-  }>({
+  const resp = await postGeweJson<GeweSendResponseData>({
     baseUrl: ctx.baseUrl,
     token: ctx.token,
     path: "/gewe/v2/api/message/postText",
@@ -62,7 +84,7 @@ export async function sendImageGewe(params: {
   imgUrl: string;
 }): Promise<GeweSendResult> {
   const ctx = buildContext(params.account);
-  const resp = await postGeweJson({
+  const resp = await postGeweJson<GeweSendResponseData>({
     baseUrl: ctx.baseUrl,
     token: ctx.token,
     path: "/gewe/v2/api/message/postImage",
@@ -83,7 +105,7 @@ export async function sendVoiceGewe(params: {
   voiceDuration: number;
 }): Promise<GeweSendResult> {
   const ctx = buildContext(params.account);
-  const resp = await postGeweJson({
+  const resp = await postGeweJson<GeweSendResponseData>({
     baseUrl: ctx.baseUrl,
     token: ctx.token,
     path: "/gewe/v2/api/message/postVoice",
@@ -106,7 +128,7 @@ export async function sendVideoGewe(params: {
   videoDuration: number;
 }): Promise<GeweSendResult> {
   const ctx = buildContext(params.account);
-  const resp = await postGeweJson({
+  const resp = await postGeweJson<GeweSendResponseData>({
     baseUrl: ctx.baseUrl,
     token: ctx.token,
     path: "/gewe/v2/api/message/postVideo",
@@ -129,7 +151,7 @@ export async function sendFileGewe(params: {
   fileName: string;
 }): Promise<GeweSendResult> {
   const ctx = buildContext(params.account);
-  const resp = await postGeweJson({
+  const resp = await postGeweJson<GeweSendResponseData>({
     baseUrl: ctx.baseUrl,
     token: ctx.token,
     path: "/gewe/v2/api/message/postFile",
@@ -153,7 +175,7 @@ export async function sendLinkGewe(params: {
   thumbUrl: string;
 }): Promise<GeweSendResult> {
   const ctx = buildContext(params.account);
-  const resp = await postGeweJson({
+  const resp = await postGeweJson<GeweSendResponseData>({
     baseUrl: ctx.baseUrl,
     token: ctx.token,
     path: "/gewe/v2/api/message/postLink",
@@ -169,3 +191,200 @@ export async function sendLinkGewe(params: {
   const data = assertGeweOk(resp, "postLink");
   return resolveSendResult({ toWxid: params.toWxid, data });
 }
+
+export async function sendAppMsgGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  appmsg: string;
+}): Promise<GeweSendResult> {
+  const ctx = buildContext(params.account);
+  const resp = await postGeweJson<GeweSendResponseData>({
+    baseUrl: ctx.baseUrl,
+    token: ctx.token,
+    path: "/gewe/v2/api/message/postAppMsg",
+    body: {
+      appId: ctx.appId,
+      toWxid: params.toWxid,
+      appmsg: params.appmsg,
+    },
+  });
+  const data = assertGeweOk(resp, "postAppMsg");
+  return resolveSendResult({ toWxid: params.toWxid, data });
+}
+
+export async function sendEmojiGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  emojiMd5: string;
+  emojiSize: number;
+}): Promise<GeweSendResult> {
+  const ctx = buildContext(params.account);
+  const resp = await postGeweJson<GeweSendResponseData>({
+    baseUrl: ctx.baseUrl,
+    token: ctx.token,
+    path: "/gewe/v2/api/message/postEmoji",
+    body: {
+      appId: ctx.appId,
+      toWxid: params.toWxid,
+      emojiMd5: params.emojiMd5,
+      emojiSize: params.emojiSize,
+    },
+  });
+  const data = assertGeweOk(resp, "postEmoji");
+  return resolveSendResult({ toWxid: params.toWxid, data });
+}
+
+export async function sendNameCardGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  nickName: string;
+  nameCardWxid: string;
+}): Promise<GeweSendResult> {
+  const ctx = buildContext(params.account);
+  const resp = await postGeweJson<GeweSendResponseData>({
+    baseUrl: ctx.baseUrl,
+    token: ctx.token,
+    path: "/gewe/v2/api/message/postNameCard",
+    body: {
+      appId: ctx.appId,
+      toWxid: params.toWxid,
+      nickName: params.nickName,
+      nameCardWxid: params.nameCardWxid,
+    },
+  });
+  const data = assertGeweOk(resp, "postNameCard");
+  return resolveSendResult({ toWxid: params.toWxid, data });
+}
+
+export async function sendMiniAppGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  miniAppId: string;
+  displayName: string;
+  pagePath: string;
+  coverImgUrl: string;
+  title: string;
+  userName: string;
+}): Promise<GeweSendResult> {
+  const ctx = buildContext(params.account);
+  const resp = await postGeweJson<GeweSendResponseData>({
+    baseUrl: ctx.baseUrl,
+    token: ctx.token,
+    path: "/gewe/v2/api/message/postMiniApp",
+    body: {
+      appId: ctx.appId,
+      toWxid: params.toWxid,
+      miniAppId: params.miniAppId,
+      displayName: params.displayName,
+      pagePath: params.pagePath,
+      coverImgUrl: params.coverImgUrl,
+      title: params.title,
+      userName: params.userName,
+    },
+  });
+  const data = assertGeweOk(resp, "postMiniApp");
+  return resolveSendResult({ toWxid: params.toWxid, data });
+}
+
+export async function revokeMessageGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  msgId: string;
+  newMsgId: string;
+  createTime: string;
+}): Promise<GeweSendResult> {
+  const ctx = buildContext(params.account);
+  const resp = await postGeweJson<GeweSendResponseData>({
+    baseUrl: ctx.baseUrl,
+    token: ctx.token,
+    path: "/gewe/v2/api/message/revokeMsg",
+    body: {
+      appId: ctx.appId,
+      toWxid: params.toWxid,
+      msgId: params.msgId,
+      newMsgId: params.newMsgId,
+      createTime: params.createTime,
+    },
+  });
+  assertGeweOk(resp, "revokeMsg");
+  return {
+    toWxid: params.toWxid,
+    messageId: params.msgId,
+    newMessageId: params.newMsgId,
+    timestamp: Number.parseInt(params.createTime, 10) * 1000 || undefined,
+  };
+}
+
+export async function forwardImageGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  xml: string;
+}): Promise<GeweSendResult> {
+  return await sendXmlForwardGewe({
+    account: params.account,
+    path: "/gewe/v2/api/message/forwardImage",
+    context: "forwardImage",
+    toWxid: params.toWxid,
+    xml: params.xml,
+  });
+}
+
+export async function forwardVideoGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  xml: string;
+}): Promise<GeweSendResult> {
+  return await sendXmlForwardGewe({
+    account: params.account,
+    path: "/gewe/v2/api/message/forwardVideo",
+    context: "forwardVideo",
+    toWxid: params.toWxid,
+    xml: params.xml,
+  });
+}
+
+export async function forwardFileGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  xml: string;
+}): Promise<GeweSendResult> {
+  return await sendXmlForwardGewe({
+    account: params.account,
+    path: "/gewe/v2/api/message/forwardFile",
+    context: "forwardFile",
+    toWxid: params.toWxid,
+    xml: params.xml,
+  });
+}
+
+export async function forwardLinkGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  xml: string;
+}): Promise<GeweSendResult> {
+  return await sendXmlForwardGewe({
+    account: params.account,
+    path: "/gewe/v2/api/message/forwardUrl",
+    context: "forwardUrl",
+    toWxid: params.toWxid,
+    xml: params.xml,
+  });
+}
+
+export async function forwardMiniAppGewe(params: {
+  account: ResolvedGeweAccount;
+  toWxid: string;
+  xml: string;
+  coverImgUrl: string;
+}): Promise<GeweSendResult> {
+  return await sendXmlForwardGewe({
+    account: params.account,
+    path: "/gewe/v2/api/message/forwardMiniApp",
+    context: "forwardMiniApp",
+    toWxid: params.toWxid,
+    xml: params.xml,
+    extraBody: {
+      coverImgUrl: params.coverImgUrl,
+    },
+  });
+}

package/src/setup-wizard-types.ts

@@ -0,0 +1,162 @@
+import type {
+  ChannelPlugin,
+  ChannelSetupInput,
+  OpenClawConfig,
+  WizardPrompter,
+} from "openclaw/plugin-sdk";
+
+type SetupCredentialValues = Partial<Record<string, string>>;
+
+export type GeweSetupWizardStatus = {
+  configuredLabel: string;
+  unconfiguredLabel: string;
+  configuredHint?: string;
+  unconfiguredHint?: string;
+  configuredScore?: number;
+  unconfiguredScore?: number;
+  resolveConfigured: (params: { cfg: OpenClawConfig }) => boolean | Promise<boolean>;
+  resolveStatusLines?: (params: {
+    cfg: OpenClawConfig;
+    configured: boolean;
+  }) => string[] | Promise<string[]>;
+};
+
+export type GeweSetupWizardCredentialState = {
+  accountConfigured: boolean;
+  hasConfiguredValue: boolean;
+  resolvedValue?: string;
+  envValue?: string;
+};
+
+export type GeweSetupWizardNote = {
+  title: string;
+  lines: string[];
+  shouldShow?: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+  }) => boolean | Promise<boolean>;
+};
+
+export type GeweSetupWizardCredential = {
+  inputKey: keyof ChannelSetupInput | string;
+  providerHint: string;
+  credentialLabel: string;
+  preferredEnvVar?: string;
+  envPrompt: string;
+  keepPrompt: string;
+  inputPrompt: string;
+  allowEnv?: (params: { cfg: OpenClawConfig; accountId: string }) => boolean;
+  inspect: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+  }) => GeweSetupWizardCredentialState;
+  applyUseEnv?: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+  }) => OpenClawConfig | Promise<OpenClawConfig>;
+  applySet?: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+    value: unknown;
+    resolvedValue: string;
+  }) => OpenClawConfig | Promise<OpenClawConfig>;
+};
+
+export type GeweSetupWizardTextInput = {
+  inputKey: keyof ChannelSetupInput | string;
+  message: string;
+  placeholder?: string;
+  required?: boolean;
+  applyEmptyValue?: boolean;
+  currentValue?: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+  }) => string | undefined | Promise<string | undefined>;
+  initialValue?: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+  }) => string | undefined | Promise<string | undefined>;
+  validate?: (params: {
+    value: string;
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+  }) => string | undefined;
+  normalizeValue?: (params: {
+    value: string;
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+  }) => string;
+  applySet?: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    value: string;
+  }) => OpenClawConfig | Promise<OpenClawConfig>;
+};
+
+export type GeweSetupWizardAllowFromEntry = {
+  input: string;
+  resolved: boolean;
+  id: string | null;
+};
+
+export type GeweSetupWizardAllowFrom = {
+  message: string;
+  placeholder: string;
+  invalidWithoutCredentialNote: string;
+  parseInputs?: (raw: string) => string[];
+  parseId: (raw: string) => string | null;
+  resolveEntries: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    credentialValues: SetupCredentialValues;
+    entries: string[];
+  }) => Promise<GeweSetupWizardAllowFromEntry[]>;
+  apply: (params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    allowFrom: string[];
+  }) => OpenClawConfig | Promise<OpenClawConfig>;
+};
+
+export type GeweSetupWizardFinalize = (params: {
+  cfg: OpenClawConfig;
+  accountId: string;
+  credentialValues: SetupCredentialValues;
+  runtime: unknown;
+  prompter: WizardPrompter;
+  options?: unknown;
+  forceAllowFrom: boolean;
+}) =>
+  | {
+      cfg?: OpenClawConfig;
+      credentialValues?: SetupCredentialValues;
+    }
+  | void
+  | Promise<
+      | {
+          cfg?: OpenClawConfig;
+          credentialValues?: SetupCredentialValues;
+        }
+      | void
+    >;
+
+export type GeweSetupWizard = {
+  channel: string;
+  status: GeweSetupWizardStatus;
+  introNote?: GeweSetupWizardNote;
+  credentials: GeweSetupWizardCredential[];
+  textInputs?: GeweSetupWizardTextInput[];
+  allowFrom?: GeweSetupWizardAllowFrom;
+  finalize?: GeweSetupWizardFinalize;
+  completionNote?: GeweSetupWizardNote;
+};
+
+export type GeweChannelPlugin<ResolvedAccount = unknown> = ChannelPlugin<ResolvedAccount> & {
+  setupWizard?: GeweSetupWizard;
+};