@emotion-machine/claw-messenger 0.1.17 → 0.1.18

package/dist/channel.d.ts

@@ -21,5 +21,5 @@ export declare function createGroup(to: string[], text: string): Promise<{
     ok: boolean;
 } & SendResult>;
 export declare const clawMessengerPlugin: ChannelPlugin<ResolvedAccount>;
-export declare function handleInboundMessage(data: Record<string, unknown>, accountId: string, account: ResolvedAccount, ctx: any): Promise<void>;
+export declare function handleInboundMessage(data: Record<string, unknown>, accountId: string, account: ResolvedAccount, ctx: any, wsOverride?: WsClient): Promise<void>;
 export {};

package/dist/channel.js

@@ -50,7 +50,7 @@ export function getWsClient(accountId) {
 // -- Connection status helper (used by tools & commands in index.ts) --
 export function getConnectionStatus() {
     const runtime = getRuntime();
-    const cfg = runtime.config.loadConfig();
+    const cfg = runtime.config.current();
     const account = resolveAccount(cfg);
     const ws = wsClients.get(account.accountId);
     return {
@@ -62,7 +62,7 @@ export function getConnectionStatus() {
 }
 export async function createGroup(to, text) {
     const runtime = getRuntime();
-    const cfg = runtime.config.loadConfig();
+    const cfg = runtime.config.current();
     const account = resolveAccount(cfg);
     const ws = wsClients.get(account.accountId);
     if (!ws)
@@ -76,7 +76,7 @@ export async function createGroup(to, text) {
 function resolveConfig(input) {
     if (input && "channels" in input)
         return input;
-    return input?.cfg ?? getRuntime().config.loadConfig();
+    return input?.cfg ?? getRuntime().config.current();
 }
 function describeClawMessageTool(input) {
     const account = resolveAccount(resolveConfig(input));
@@ -426,7 +426,7 @@ export const clawMessengerPlugin = {
 // versions doesn't include it. Newer OpenClaw calls this; older versions ignore it.
 clawMessengerPlugin.describeMessageTool = describeClawMessageTool;
 // -- Inbound message handler --
-export async function handleInboundMessage(data, accountId, account, ctx) {
+export async function handleInboundMessage(data, accountId, account, ctx, wsOverride) {
     const normalized = normalizeInboundMessage(data);
     if (!normalized.ok) {
         ctx.log?.warn?.(`[${accountId}] Dropping inbound message: ${normalized.reason}`);
@@ -434,7 +434,7 @@ export async function handleInboundMessage(data, accountId, account, ctx) {
     }
     const { from, text, messageId, attachments, isGroup, chatId, participants, } = normalized.message;
     const runtime = getRuntime();
-    const cfg = runtime.config.loadConfig();
+    const cfg = runtime.config.current();
     // Resolve routing — group by chatId, DM by sender phone
     let rawRoute;
     try {
@@ -482,13 +482,11 @@ export async function handleInboundMessage(data, accountId, account, ctx) {
     const rawBody = text || (allMedia.length > 0 ? "<media:image>" : "");
     if (!rawBody)
         return;
-    const body = runtime.channel.reply.formatInboundEnvelope({
+    const body = runtime.channel.reply.formatAgentEnvelope({
         channel: "Claw Messenger",
         from,
         timestamp: Date.now(),
         body: rawBody,
-        chatType: isGroup ? "group" : "direct",
-        sender: { id: from },
         previousTimestamp,
         envelope: envelopeOptions,
     });
@@ -523,7 +521,7 @@ export async function handleInboundMessage(data, accountId, account, ctx) {
         sessionKey: ctxPayload.SessionKey ?? routeSessionKey,
         ctx: ctxPayload,
     }).catch(() => { });
-    const ws = wsClients.get(accountId);
+    const ws = wsOverride ?? wsClients.get(accountId);
     // Mark as read + start typing (DM only — skip for groups)
     if (!isGroup && ws) {
         ws.send({ type: "read", to: from });

package/dist/index.js

@@ -39,18 +39,16 @@ const plugin = {
                     };
                 }
                 const runtime = getRuntime();
-                const cfg = runtime.config.loadConfig();
-                const updated = {
-                    ...cfg,
-                    channels: {
-                        ...cfg.channels,
-                        "claw-messenger": {
-                            ...(cfg.channels?.["claw-messenger"] ?? {}),
+                await runtime.config.mutateConfigFile({
+                    afterWrite: { mode: "auto" },
+                    mutate(draft) {
+                        draft.channels ??= {};
+                        draft.channels["claw-messenger"] = {
+                            ...(draft.channels["claw-messenger"] ?? {}),
                             preferredService: service,
-                        },
+                        };
                     },
-                };
-                await runtime.config.writeConfigFile(updated);
+                });
                 return {
                     content: [{ type: "text", text: JSON.stringify({ ok: true, preferredService: service }) }],
                 };
@@ -99,7 +97,7 @@ const plugin = {
                 const ws = getWsClient(status.accountId);
                 const diagnostics = ws?.getDiagnostics() ?? { errors: [], connectionLog: [] };
                 const report = {
-                    plugin_version: "0.1.15",
+                    plugin_version: "0.1.18",
                     node_version: process.version,
                     connected: status.connected,
                     server_url: status.serverUrl,
@@ -111,7 +109,7 @@ const plugin = {
                 if (submit && status.connected) {
                     try {
                         const runtime = getRuntime();
-                        const cfg = runtime.config.loadConfig();
+                        const cfg = runtime.config.current();
                         const account = (cfg.channels?.["claw-messenger"] ?? {});
                         const apiKey = account.apiKey ?? "";
                         const serverUrl = account.serverUrl ?? "https://claw-messenger.onrender.com";
@@ -177,18 +175,16 @@ const plugin = {
                     return { text: `Invalid service "${arg}". Must be one of: ${VALID_SERVICES.join(", ")}` };
                 }
                 const runtime = getRuntime();
-                const cfg = runtime.config.loadConfig();
-                const updated = {
-                    ...cfg,
-                    channels: {
-                        ...cfg.channels,
-                        "claw-messenger": {
-                            ...(cfg.channels?.["claw-messenger"] ?? {}),
+                await runtime.config.mutateConfigFile({
+                    afterWrite: { mode: "auto" },
+                    mutate(draft) {
+                        draft.channels ??= {};
+                        draft.channels["claw-messenger"] = {
+                            ...(draft.channels["claw-messenger"] ?? {}),
                             preferredService: match,
-                        },
+                        };
                     },
-                };
-                await runtime.config.writeConfigFile(updated);
+                });
                 return { text: `Preferred service switched to ${match}` };
             },
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emotion-machine/claw-messenger",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "OpenClaw channel plugin for Claw Messenger, a managed, Mac-free iMessage, RCS, and SMS API for AI agents.",
   "type": "module",
   "main": "dist/index.js",
@@ -59,6 +59,9 @@
     "install": {
       "npmSpec": "@emotion-machine/claw-messenger",
       "defaultChoice": "npm"
+    },
+    "compat": {
+      "pluginApi": ">=2026.8.1"
     }
   },
   "dependencies": {
@@ -66,6 +69,14 @@
     "ws": "^8.18.0",
     "zod": "^4.3.6"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.8.1"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^20.14.0",
     "@types/ws": "^8.5.0",

package/src/types/openclaw.d.ts

@@ -150,8 +150,11 @@ declare module "openclaw/plugin-sdk/channel-core" {
   export interface PluginRuntime {
     version: string;
     config: {
-      loadConfig(): OpenclawConfig;
-      writeConfigFile(cfg: OpenclawConfig): Promise<void>;
+      current(): OpenclawConfig;
+      mutateConfigFile<T = void>(params: {
+        afterWrite: { mode: "auto" | "restart" | "none"; reason?: string };
+        mutate(draft: OpenclawConfig): T | void;
+      }): Promise<{ result?: T; [key: string]: any }>;
     };
     system: {
       enqueueSystemEvent(event: any): void;
@@ -175,7 +178,7 @@ declare module "openclaw/plugin-sdk/channel-core" {
       reply: {
         dispatchReplyWithBufferedBlockDispatcher(ctx: any): Promise<any>;
         resolveEffectiveMessagesConfig(cfg: OpenclawConfig, agentId?: string): any;
-        formatInboundEnvelope(ctx: any): string;
+        formatAgentEnvelope(ctx: any): string;
         finalizeInboundContext(ctx: any): any;
         resolveEnvelopeFormatOptions(cfg: OpenclawConfig): any;
         [key: string]: any;