openclaw-seatalk 0.1.6 → 0.2.1

package/README.md

@@ -63,16 +63,15 @@ openclaw plugins install openclaw-seatalk
 
 OpenClaw downloads the package, installs dependencies, and registers the plugin automatically. The plugin will appear in the `openclaw onboard` channel selection.
 
-To install and pin a specific version:
+| Plugin version | OpenClaw version |
+|---------------|-----------------|
+| 0.2.x | >= 2026.3.22 |
+| 0.1.x | < 2026.3.22 |
 
-```bash
-openclaw plugins install openclaw-seatalk --pin
-```
-
-To update to the latest version (restart the gateway afterwards to apply):
+v0.2.0 migrated to the new plugin SDK (`openclaw/plugin-sdk/*`). If you are running OpenClaw < 2026.3.22, pin to 0.1.x:
 
 ```bash
-openclaw plugins update openclaw-seatalk
+openclaw plugins install openclaw-seatalk@0.1.6
 ```
 
 ### From source (development)
@@ -86,6 +85,25 @@ npm install
 openclaw plugins install -l .
 ```
 
+## Upgrading
+
+```bash
+openclaw plugins update openclaw-seatalk
+openclaw gateway restart
+```
+
+Upgrading OpenClaw across the 2026.3.22 SDK boundary (e.g. 2026.3.13 -> 2026.3.22):
+
+```bash
+openclaw plugins disable openclaw-seatalk
+openclaw update
+openclaw plugins update openclaw-seatalk
+openclaw plugins enable openclaw-seatalk
+openclaw gateway restart
+```
+
+The plugin must be disabled before upgrading because the old plugin (0.1.x) imports SDK exports removed in OpenClaw >= 2026.3.22. Disabling prevents it from loading during the upgrade.
+
 ## Gateway Modes
 
 The plugin supports two gateway modes for receiving SeaTalk events:
@@ -132,7 +150,7 @@ Or edit the OpenClaw config file directly (`~/.openclaw/openclaw.json`).
       webhookPort: 3210,
       webhookPath: "/callback",
       dmPolicy: "open",  // or "allowlist"
-      // allowFrom: ["e_12345678", "alice@company.com"],
+      // allowFrom: ["12345678", "alice@company.com"],
     },
   },
 }

package/index.ts

@@ -1,29 +1,22 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/core";
 import { seatalkPlugin } from "./src/channel.js";
 import { setSeatalkRuntime } from "./src/runtime.js";
 import { registerSeaTalkTool } from "./src/tool.js";
 
-export { monitorSeaTalkProvider } from "./src/monitor.js";
 export {
-	sendSeaTalkMessage,
 	sendTextMessage,
 	sendImageMessage,
 	sendFileMessage,
 } from "./src/send.js";
 export { probeSeaTalk } from "./src/probe.js";
+export { monitorSeaTalkProvider } from "./src/monitor.js";
 export { seatalkPlugin } from "./src/channel.js";
 
-const plugin = {
+export default defineChannelPluginEntry({
 	id: "openclaw-seatalk",
 	name: "SeaTalk",
 	description: "SeaTalk channel plugin",
-	configSchema: emptyPluginConfigSchema(),
-	register(api: OpenClawPluginApi) {
-		setSeatalkRuntime(api.runtime);
-		api.registerChannel({ plugin: seatalkPlugin });
-		registerSeaTalkTool(api);
-	},
-};
-
-export default plugin;
+	plugin: seatalkPlugin,
+	setRuntime: setSeatalkRuntime,
+	registerFull: (api) => registerSeaTalkTool(api),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "openclaw-seatalk",
-	"version": "0.1.6",
+	"version": "0.2.1",
 	"description": "OpenClaw SeaTalk channel plugin",
 	"type": "module",
 	"license": "Apache-2.0",
@@ -14,7 +14,7 @@
 	"engines": {
 		"node": ">=22.16.0"
 	},
-	"files": ["index.ts", "src/", "openclaw.plugin.json"],
+	"files": ["index.ts", "setup-entry.ts", "src/", "openclaw.plugin.json"],
 	"scripts": {
 		"format": "biome format --write .",
 		"format:check": "biome format .",
@@ -33,6 +33,14 @@
 		"@types/ws": "^8.5.0",
 		"openclaw": "latest"
 	},
+	"peerDependencies": {
+		"openclaw": ">=2026.3.22"
+	},
+	"peerDependenciesMeta": {
+		"openclaw": {
+			"optional": true
+		}
+	},
 	"pnpm": {
 		"onlyBuiltDependencies": ["@biomejs/biome"]
 	},
@@ -49,6 +57,9 @@
 		"install": {
 			"npmSpec": "openclaw-seatalk",
 			"defaultChoice": "npm"
+		},
+		"compat": {
+			"pluginApi": ">=2026.3.22"
 		}
 	}
 }

package/setup-entry.ts

@@ -0,0 +1,4 @@
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
+import { seatalkPlugin } from "./src/channel.js";
+
+export default defineSetupPluginEntry(seatalkPlugin);

package/src/accounts.ts

@@ -1,8 +1,8 @@
-import type { ClawdbotConfig } from "openclaw/plugin-sdk";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk";
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/core";
 import type { ResolvedSeaTalkAccount, SeaTalkAccountConfig, SeaTalkConfig } from "./types.js";
 
-function listConfiguredAccountIds(cfg: ClawdbotConfig): string[] {
+function listConfiguredAccountIds(cfg: OpenClawConfig): string[] {
 	const accounts = (cfg.channels?.seatalk as SeaTalkConfig)?.accounts;
 	if (!accounts || typeof accounts !== "object") {
 		return [];
@@ -10,7 +10,7 @@ function listConfiguredAccountIds(cfg: ClawdbotConfig): string[] {
 	return Object.keys(accounts).filter(Boolean);
 }
 
-export function listSeaTalkAccountIds(cfg: ClawdbotConfig): string[] {
+export function listSeaTalkAccountIds(cfg: OpenClawConfig): string[] {
 	const ids = listConfiguredAccountIds(cfg);
 	if (ids.length === 0) {
 		return [DEFAULT_ACCOUNT_ID];
@@ -18,7 +18,7 @@ export function listSeaTalkAccountIds(cfg: ClawdbotConfig): string[] {
 	return [...ids].toSorted((a, b) => a.localeCompare(b));
 }
 
-export function resolveDefaultSeaTalkAccountId(cfg: ClawdbotConfig): string {
+export function resolveDefaultSeaTalkAccountId(cfg: OpenClawConfig): string {
 	const ids = listSeaTalkAccountIds(cfg);
 	if (ids.includes(DEFAULT_ACCOUNT_ID)) {
 		return DEFAULT_ACCOUNT_ID;
@@ -27,7 +27,7 @@ export function resolveDefaultSeaTalkAccountId(cfg: ClawdbotConfig): string {
 }
 
 function resolveAccountConfig(
-	cfg: ClawdbotConfig,
+	cfg: OpenClawConfig,
 	accountId: string,
 ): SeaTalkAccountConfig | undefined {
 	const accounts = (cfg.channels?.seatalk as SeaTalkConfig)?.accounts;
@@ -37,7 +37,7 @@ function resolveAccountConfig(
 	return accounts[accountId];
 }
 
-function mergeSeaTalkAccountConfig(cfg: ClawdbotConfig, accountId: string): SeaTalkConfig {
+function mergeSeaTalkAccountConfig(cfg: OpenClawConfig, accountId: string): SeaTalkConfig {
 	const seatalkCfg = cfg.channels?.seatalk as SeaTalkConfig | undefined;
 	const { accounts: _ignored, ...base } = seatalkCfg ?? {};
 	const account = resolveAccountConfig(cfg, accountId) ?? {};
@@ -59,7 +59,7 @@ export function resolveSeaTalkCredentials(cfg?: SeaTalkConfig): {
 }
 
 export function resolveSeaTalkAccount(params: {
-	cfg: ClawdbotConfig;
+	cfg: OpenClawConfig;
 	accountId?: string | null;
 }): ResolvedSeaTalkAccount {
 	const accountId = normalizeAccountId(params.accountId);
@@ -86,7 +86,7 @@ export function resolveSeaTalkAccount(params: {
 	};
 }
 
-export function listEnabledSeaTalkAccounts(cfg: ClawdbotConfig): ResolvedSeaTalkAccount[] {
+export function listEnabledSeaTalkAccounts(cfg: OpenClawConfig): ResolvedSeaTalkAccount[] {
 	return listSeaTalkAccountIds(cfg)
 		.map((accountId) => resolveSeaTalkAccount({ cfg, accountId }))
 		.filter((account) => account.enabled && account.configured);

package/src/bot.ts

@@ -1,9 +1,13 @@
-import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import {
+	resolveSendableOutboundReplyParts,
+	sendMediaWithLeadingCaption,
+} from "openclaw/plugin-sdk/reply-payload";
 import { resolveSeaTalkAccount } from "./accounts.js";
 import type { SeaTalkClient } from "./client.js";
 import { buildSeaTalkMediaPayload, resolveInboundMedia } from "./media.js";
 import { getSeatalkRuntime } from "./runtime.js";
-import { sendGroupTextMessage, sendTextMessage } from "./send.js";
+import { sendGroupTextMessage, sendMediaToTarget, sendTextMessage } from "./send.js";
 import type {
 	SeaTalkCallbackRequest,
 	SeaTalkGroupMessageEvent,
@@ -13,7 +17,7 @@ import type {
 } from "./types.js";
 
 export function dispatchSeaTalkEvent(params: {
-	cfg: ClawdbotConfig;
+	cfg: OpenClawConfig;
 	event: SeaTalkCallbackRequest;
 	client: SeaTalkClient;
 	runtime?: RuntimeEnv;
@@ -83,11 +87,22 @@ function tryRecordEvent(eventId: string): boolean {
 const DEBOUNCE_SLIDE_MS = 1500;
 const DEBOUNCE_HARD_CAP_MS = 5000;
 
-type BufferEntry = {
+type DmBufferEntry = {
+	kind: "dm";
 	event: SeaTalkCallbackRequest;
 	parsedEvent: SeaTalkMessageEvent;
 };
 
+type GroupBufferEntry = {
+	kind: "group";
+	event: SeaTalkCallbackRequest;
+	groupEvent: SeaTalkGroupMessageEvent;
+	groupId: string;
+	eventType: string;
+};
+
+type BufferEntry = DmBufferEntry | GroupBufferEntry;
+
 type DebounceState = {
 	entries: BufferEntry[];
 	timer: ReturnType<typeof setTimeout>;
@@ -96,7 +111,7 @@ type DebounceState = {
 };
 
 type DebounceContext = {
-	cfg: ClawdbotConfig;
+	cfg: OpenClawConfig;
 	client: SeaTalkClient;
 	runtime?: RuntimeEnv;
 	accountId: string;
@@ -110,6 +125,17 @@ function dmDebounceKey(accountId: string, employeeCode: string, threadId?: strin
 		: `${accountId}:dm:${employeeCode}`;
 }
 
+function groupDebounceKey(
+	accountId: string,
+	groupId: string,
+	employeeCode: string,
+	threadId?: string,
+): string {
+	return threadId
+		? `${accountId}:grp:${groupId}:${employeeCode}:t:${threadId}`
+		: `${accountId}:grp:${groupId}:${employeeCode}`;
+}
+
 function scheduleFlush(key: string, state: DebounceState): void {
 	clearTimeout(state.timer);
 
@@ -133,10 +159,20 @@ function flushBuffer(key: string): void {
 	const entries = state.entries;
 	if (entries.length === 0) return;
 
-	processBufferedEvents(entries, state.context).catch((err) => {
-		const error = state.context.runtime?.error ?? console.error;
-		error(`seatalk[${state.context.accountId}]: flush error: ${String(err)}`);
-	});
+	const first = entries[0];
+	if (first.kind === "dm") {
+		const dmEntries = entries as DmBufferEntry[];
+		processBufferedDmEvents(dmEntries, state.context).catch((err) => {
+			const error = state.context.runtime?.error ?? console.error;
+			error(`seatalk[${state.context.accountId}]: flush error: ${String(err)}`);
+		});
+	} else {
+		const groupEntries = entries as GroupBufferEntry[];
+		processBufferedGroupEvents(groupEntries, state.context).catch((err) => {
+			const error = state.context.runtime?.error ?? console.error;
+			error(`seatalk[${state.context.accountId}]: group flush error: ${String(err)}`);
+		});
+	}
 }
 
 function pushToBuffer(key: string, entry: BufferEntry, context: DebounceContext): void {
@@ -204,8 +240,29 @@ async function resolveQuotedMessage(params: {
 	}
 }
 
-async function processBufferedEvents(
-	entries: BufferEntry[],
+async function deliverMediaReplies(params: {
+	mediaUrls: string[];
+	client: SeaTalkClient;
+	to: string;
+	threadId?: string;
+	isGroup: boolean;
+	log: (msg: string) => void;
+}): Promise<void> {
+	const { mediaUrls, client, to, threadId, isGroup, log } = params;
+	await sendMediaWithLeadingCaption({
+		mediaUrls,
+		caption: "",
+		send: async ({ mediaUrl }) => {
+			await sendMediaToTarget({ client, to, mediaUrl, threadId, isGroup });
+		},
+		onError: async ({ error, mediaUrl }) => {
+			log(`seatalk: failed to send media ${mediaUrl}: ${String(error)}`);
+		},
+	});
+}
+
+async function processBufferedDmEvents(
+	entries: DmBufferEntry[],
 	context: DebounceContext,
 ): Promise<void> {
 	const { cfg, client, runtime, accountId } = context;
@@ -267,12 +324,15 @@ async function processBufferedEvents(
 		if (media) mediaList.push(media);
 	}
 
-	const quotedMessageId = first.message.quoted_message_id;
-	let quotedText: string | null = null;
-	if (quotedMessageId) {
-		const quoted = await resolveQuotedMessage({ client, quotedMessageId, log });
+	const seenQuotedIds = new Set<string>();
+	const quotedTexts: string[] = [];
+	for (const { parsedEvent } of entries) {
+		const qid = parsedEvent.message.quoted_message_id;
+		if (!qid || seenQuotedIds.has(qid)) continue;
+		seenQuotedIds.add(qid);
+		const quoted = await resolveQuotedMessage({ client, quotedMessageId: qid, log });
 		if (quoted) {
-			quotedText = quoted.text;
+			quotedTexts.push(quoted.text);
 			mediaList.push(...quoted.media);
 		}
 	}
@@ -280,8 +340,9 @@ async function processBufferedEvents(
 	const mediaPayload = buildSeaTalkMediaPayload(mediaList);
 
 	let messageText = textParts.join("\n");
-	if (quotedText) {
-		messageText = messageText ? `${quotedText}\n${messageText}` : quotedText;
+	if (quotedTexts.length > 0) {
+		const quotedBlock = quotedTexts.join("\n");
+		messageText = messageText ? `${quotedBlock}\n${messageText}` : quotedBlock;
 	}
 	if (!messageText && mediaList.length > 0) {
 		messageText = mediaList.map((m) => m.placeholder).join(" ");
@@ -331,7 +392,8 @@ async function processBufferedEvents(
 
 		const metadata: Record<string, string> = {};
 		if (threadId) metadata.threadId = threadId;
-		if (quotedMessageId) metadata.quotedMessageId = quotedMessageId;
+		const firstQuotedId = first.message.quoted_message_id;
+		if (firstQuotedId) metadata.quotedMessageId = firstQuotedId;
 
 		const ctxPayload = core.channel.reply.finalizeInboundContext({
 			Body: body,
@@ -368,12 +430,25 @@ async function processBufferedEvents(
 		const typingResult = core.channel.reply.createReplyDispatcherWithTyping({
 			humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, route.agentId),
 			deliver: async (payload) => {
-				const text = payload.text?.trim();
-				if (text) {
+				const reply = resolveSendableOutboundReplyParts(payload);
+				if (!reply.hasText && !reply.hasMedia) return;
+
+				if (reply.hasText) {
 					log(
 						`seatalk[${accountId}]: inline deliver DM to ${employeeCode} threadId=${threadId || "none"}`,
 					);
-					await sendTextMessage(client, employeeCode, text, 1, threadId);
+					await sendTextMessage(client, employeeCode, reply.trimmedText, 1, threadId);
+				}
+
+				if (reply.hasMedia) {
+					await deliverMediaReplies({
+						mediaUrls: reply.mediaUrls,
+						client,
+						to: employeeCode,
+						threadId,
+						isGroup: false,
+						log,
+					});
 				}
 			},
 			onError: (err) => {
@@ -408,7 +483,7 @@ async function processBufferedEvents(
 }
 
 export async function handleSeaTalkMessage(params: {
-	cfg: ClawdbotConfig;
+	cfg: OpenClawConfig;
 	event: SeaTalkCallbackRequest;
 	client: SeaTalkClient;
 	runtime?: RuntimeEnv;
@@ -417,7 +492,7 @@ export async function handleSeaTalkMessage(params: {
 	const { cfg, event, client, runtime, accountId } = params;
 	const log = runtime?.log ?? console.log;
 
-	if (!tryRecordEvent(event.event_id)) {
+	if (!tryRecordEvent(`${accountId}:${event.event_id}`)) {
 		log(`seatalk[${accountId}]: skipping duplicate event ${event.event_id}`);
 		return;
 	}
@@ -433,14 +508,11 @@ export async function handleSeaTalkMessage(params: {
 	);
 
 	const key = dmDebounceKey(accountId, msgEvent.employee_code, msgEvent.message.thread_id);
-	pushToBuffer(key, { event, parsedEvent: msgEvent }, { cfg, client, runtime, accountId });
-}
-
-function extractGroupText(msg: SeaTalkMessage): string {
-	if (msg.tag === "text") {
-		return msg.text?.plain_text ?? msg.text?.content ?? "";
-	}
-	return "";
+	pushToBuffer(
+		key,
+		{ kind: "dm", event, parsedEvent: msgEvent },
+		{ cfg, client, runtime, accountId },
+	);
 }
 
 function checkGroupAccess(params: {
@@ -491,7 +563,7 @@ function checkGroupAccess(params: {
 }
 
 export async function handleSeaTalkGroupMessage(params: {
-	cfg: ClawdbotConfig;
+	cfg: OpenClawConfig;
 	event: SeaTalkCallbackRequest;
 	client: SeaTalkClient;
 	runtime?: RuntimeEnv;
@@ -499,9 +571,8 @@ export async function handleSeaTalkGroupMessage(params: {
 }): Promise<void> {
 	const { cfg, event, client, runtime, accountId } = params;
 	const log = runtime?.log ?? console.log;
-	const error = runtime?.error ?? console.error;
 
-	if (!tryRecordEvent(event.event_id)) {
+	if (!tryRecordEvent(`${accountId}:${event.event_id}`)) {
 		log(`seatalk[${accountId}]: skipping duplicate group event ${event.event_id}`);
 		return;
 	}
@@ -546,16 +617,51 @@ export async function handleSeaTalkGroupMessage(params: {
 		return;
 	}
 
+	const key = groupDebounceKey(accountId, groupId, employeeCode, threadId);
+	pushToBuffer(
+		key,
+		{ kind: "group", event, groupEvent, groupId, eventType: event.event_type },
+		{ cfg, client, runtime, accountId },
+	);
+}
+
+async function processBufferedGroupEvents(
+	entries: GroupBufferEntry[],
+	context: DebounceContext,
+): Promise<void> {
+	const { cfg, client, runtime, accountId } = context;
+	const log = runtime?.log ?? console.log;
+	const error = runtime?.error ?? console.error;
+
+	const first = entries[0];
+	const groupId = first.groupId;
+	const msg = first.groupEvent.message;
+	const sender = msg.sender;
+	const employeeCode = sender.employee_code;
+	const senderEmail = sender.email;
+	const threadId = msg.thread_id;
+
+	const textParts: string[] = [];
 	const mediaMessages: SeaTalkMessage[] = [];
-	let messageText = "";
-
-	if (msg.tag === "text") {
-		messageText = extractGroupText(msg);
-	} else if (msg.tag === "image" || msg.tag === "file" || msg.tag === "video") {
-		mediaMessages.push(msg);
-	} else if (msg.tag === "combined_forwarded_chat_history") {
-		log(`seatalk[${accountId}]: skipping combined_forwarded_chat_history in group ${groupId}`);
-		return;
+
+	for (const { groupEvent } of entries) {
+		const m = groupEvent.message;
+		switch (m.tag) {
+			case "text":
+				if (m.text?.plain_text || m.text?.content)
+					textParts.push(m.text.plain_text ?? m.text.content ?? "");
+				break;
+			case "image":
+			case "file":
+			case "video":
+				mediaMessages.push(m);
+				break;
+			case "combined_forwarded_chat_history":
+				log(
+					`seatalk[${accountId}]: skipping combined_forwarded_chat_history in group ${groupId}`,
+				);
+				break;
+		}
 	}
 
 	const mediaList: SeaTalkMediaInfo[] = [];
@@ -564,7 +670,7 @@ export async function handleSeaTalkGroupMessage(params: {
 		if (media) mediaList.push(media);
 	}
 
-	const quotedMessageId = msg.quoted_message_id;
+	const quotedMessageId = first.groupEvent.message.quoted_message_id;
 	let quotedText: string | null = null;
 	if (quotedMessageId) {
 		const quoted = await resolveQuotedMessage({ client, quotedMessageId, log });
@@ -576,6 +682,7 @@ export async function handleSeaTalkGroupMessage(params: {
 
 	const mediaPayload = buildSeaTalkMediaPayload(mediaList);
 
+	let messageText = textParts.join("\n");
 	if (quotedText) {
 		messageText = messageText ? `${quotedText}\n${messageText}` : quotedText;
 	}
@@ -591,6 +698,9 @@ export async function handleSeaTalkGroupMessage(params: {
 
 	const senderName = employeeCode + (senderEmail ? ` (${senderEmail})` : "");
 	const messageId = msg.message_id;
+	const wasMentioned = entries.some(
+		(e) => e.eventType === "new_mentioned_message_received_from_group_chat",
+	);
 
 	try {
 		const core = getSeatalkRuntime();
@@ -620,6 +730,9 @@ export async function handleSeaTalkGroupMessage(params: {
 			body: `${senderName}: ${messageText}`,
 		});
 
+		const account = resolveSeaTalkAccount({ cfg, accountId });
+		const seatalkCfg = account.config;
+
 		const metadata: Record<string, string> = { groupId };
 		if (threadId) metadata.threadId = threadId;
 		if (quotedMessageId) metadata.quotedMessageId = quotedMessageId;
@@ -641,7 +754,7 @@ export async function handleSeaTalkGroupMessage(params: {
 			MessageSid: messageId,
 			MessageThreadId: threadId || undefined,
 			Timestamp: Date.now(),
-			WasMentioned: event.event_type === "new_mentioned_message_received_from_group_chat",
+			WasMentioned: wasMentioned,
 			CommandAuthorized: true,
 			OriginatingChannel: "seatalk" as const,
 			OriginatingTo: `group:${groupId}`,
@@ -661,9 +774,28 @@ export async function handleSeaTalkGroupMessage(params: {
 		const typingResult = core.channel.reply.createReplyDispatcherWithTyping({
 			humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, route.agentId),
 			deliver: async (payload) => {
-				const text = payload.text?.trim();
-				if (text) {
-					await sendGroupTextMessage(client, groupId, text, 1, replyThreadId);
+				const reply = resolveSendableOutboundReplyParts(payload);
+				if (!reply.hasText && !reply.hasMedia) return;
+
+				if (reply.hasText) {
+					await sendGroupTextMessage(
+						client,
+						groupId,
+						reply.trimmedText,
+						1,
+						replyThreadId,
+					);
+				}
+
+				if (reply.hasMedia) {
+					await deliverMediaReplies({
+						mediaUrls: reply.mediaUrls,
+						client,
+						to: groupId,
+						threadId: replyThreadId,
+						isGroup: true,
+						log,
+					});
 				}
 			},
 			onError: (err) => {

package/src/channel.ts

@@ -1,18 +1,18 @@
-import type { ChannelMeta, ChannelPlugin, ClawdbotConfig } from "openclaw/plugin-sdk";
-import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk";
+import type { ChannelPlugin, OpenClawConfig } from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/core";
 import {
 	listSeaTalkAccountIds,
 	resolveDefaultSeaTalkAccountId,
 	resolveSeaTalkAccount,
 } from "./accounts.js";
 import { resolveSeaTalkClient } from "./client.js";
-import { seatalkOnboardingAdapter } from "./onboarding.js";
 import { seatalkOutbound } from "./outbound.js";
 import { probeSeaTalk } from "./probe.js";
+import { seatalkSetupWizard } from "./setup-surface.js";
 import { looksLikeEmail, looksLikeSeaTalkId, normalizeSeaTalkTarget } from "./targets.js";
 import type { ResolvedSeaTalkAccount, SeaTalkConfig } from "./types.js";
 
-const meta: ChannelMeta = {
+const meta = {
 	id: "seatalk",
 	label: "SeaTalk",
 	selectionLabel: "SeaTalk (plugin)",
@@ -135,7 +135,7 @@ export const seatalkPlugin: ChannelPlugin<ResolvedSeaTalkAccount> = {
 			const isDefault = accountId === DEFAULT_ACCOUNT_ID;
 
 			if (isDefault) {
-				const next = { ...cfg } as ClawdbotConfig;
+				const next = { ...cfg } as OpenClawConfig;
 				const nextChannels = { ...cfg.channels } as Record<string, unknown>;
 				nextChannels.seatalk = undefined;
 				const hasOtherChannels = Object.values(nextChannels).some((v) => v !== undefined);
@@ -224,7 +224,7 @@ export const seatalkPlugin: ChannelPlugin<ResolvedSeaTalkAccount> = {
 			};
 		},
 	},
-	onboarding: seatalkOnboardingAdapter,
+	setupWizard: seatalkSetupWizard,
 	messaging: {
 		normalizeTarget: (raw) => normalizeSeaTalkTarget(raw) ?? undefined,
 		targetResolver: {

package/src/monitor.ts

@@ -1,6 +1,6 @@
 import * as crypto from "node:crypto";
 import * as http from "node:http";
-import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
 import {
 	listEnabledSeaTalkAccounts,
 	resolveSeaTalkAccount,
@@ -11,7 +11,7 @@ import { resolveSeaTalkClient } from "./client.js";
 import type { ResolvedSeaTalkAccount, SeaTalkCallbackRequest } from "./types.js";
 
 export type MonitorSeaTalkOpts = {
-	config?: ClawdbotConfig;
+	config?: OpenClawConfig;
 	runtime?: RuntimeEnv;
 	abortSignal?: AbortSignal;
 	accountId?: string;
@@ -61,7 +61,7 @@ function readBody(req: http.IncomingMessage): Promise<Buffer> {
 }
 
 async function monitorSingleAccount(params: {
-	cfg: ClawdbotConfig;
+	cfg: OpenClawConfig;
 	account: ResolvedSeaTalkAccount;
 	runtime?: RuntimeEnv;
 	abortSignal?: AbortSignal;