@emotion-machine/claw-messenger 0.1.13 → 0.1.15

package/README.md

@@ -57,8 +57,17 @@ The plugin registers two tools your agent can call:
 2. Create an API key from the dashboard
 3. Install the plugin: `openclaw plugins install @emotion-machine/claw-messenger`
 4. Add the config above with your API key
-5. Start a conversation — your agent can now send and receive messages
+5. Restart OpenClaw so the channel connects
+6. Check the listener before the first controlled send:
+
+   ```bash
+   curl https://claw-messenger.onrender.com/api/agent/readiness \
+     -H "Authorization: Bearer ${CLAW_API_KEY}"
+   ```
+
+   Continue only after the response is `{"ready":true,"action":"send_controlled_test"}`. If the action is `connect_agent`, restart OpenClaw and check again. Keep the key in the authorization header, never in the URL.
+7. Send one message to a phone you control, reply in the same thread, and confirm the reply reaches your agent
 
 ## License
 
-UNLICENSED
+UNLICENSED

package/dist/channel.d.ts

@@ -1,4 +1,4 @@
-import type { ChannelPlugin } from "openclaw/plugin-sdk";
+import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { type ClawMessengerConfig } from "./config.js";
 import { WsClient } from "./ws/client.js";
 import { type SendResult } from "./outbound/send.js";
@@ -21,4 +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 {};

package/dist/channel.js

@@ -1,4 +1,4 @@
-import * as pluginSdk from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID as OPENCLAW_DEFAULT_ACCOUNT_ID, PAIRING_APPROVED_MESSAGE, buildChannelConfigSchema, formatPairingApproveHint, normalizeAccountId, } from "openclaw/plugin-sdk/channel-plugin-common";
 import { ClawMessengerConfigSchema } from "./config.js";
 import { isInboundMessageEvent, normalizeInboundMessage, validateInboundRoute, } from "./inbound.js";
 import { getRuntime } from "./runtime.js";
@@ -25,7 +25,7 @@ function hasAccountId(value) {
 }
 function normalizeAccountIdCompat(accountId) {
     const fallback = hasAccountId(accountId) ? accountId.trim() : FALLBACK_ACCOUNT_ID;
-    const normalize = pluginSdk.normalizeAccountId;
+    const normalize = normalizeAccountId;
     if (typeof normalize === "function") {
         try {
             const normalized = normalize(fallback);
@@ -38,7 +38,7 @@ function normalizeAccountIdCompat(accountId) {
     }
     return fallback;
 }
-const DEFAULT_ACCOUNT_ID = normalizeAccountIdCompat(pluginSdk.DEFAULT_ACCOUNT_ID);
+const DEFAULT_ACCOUNT_ID = normalizeAccountIdCompat(OPENCLAW_DEFAULT_ACCOUNT_ID);
 const MESSAGE_TOOL_ACTIONS = ["send", "react"];
 function resolveAccount(cfg, accountId) {
     const cloudConfig = (cfg.channels?.["claw-messenger"] ?? {});
@@ -121,7 +121,7 @@ export const clawMessengerPlugin = {
             const ws = wsClients.get(account.accountId);
             if (!ws)
                 throw new Error("Not connected to claw-messenger");
-            await sendText(ws, id, pluginSdk.PAIRING_APPROVED_MESSAGE, account.preferredService);
+            await sendText(ws, id, PAIRING_APPROVED_MESSAGE, account.preferredService);
         },
     },
     capabilities: {
@@ -133,7 +133,7 @@ export const clawMessengerPlugin = {
         blockStreaming: true,
     },
     reload: { configPrefixes: ["channels.claw-messenger"] },
-    configSchema: pluginSdk.buildChannelConfigSchema(ClawMessengerConfigSchema),
+    configSchema: buildChannelConfigSchema(ClawMessengerConfigSchema),
     config: {
         listAccountIds: () => [DEFAULT_ACCOUNT_ID],
         resolveAccount: (cfg, accountId) => resolveAccount(cfg, accountId),
@@ -167,7 +167,7 @@ export const clawMessengerPlugin = {
             allowFrom: account.config.allowFrom ?? [],
             policyPath: "channels.claw-messenger.dmPolicy",
             allowFromPath: "channels.claw-messenger.",
-            approveHint: pluginSdk.formatPairingApproveHint("claw-messenger"),
+            approveHint: formatPairingApproveHint("claw-messenger"),
         }),
         collectWarnings: ({ cfg }) => {
             const account = resolveAccount(cfg);
@@ -439,7 +439,7 @@ export const clawMessengerPlugin = {
 // versions doesn't include it. Newer OpenClaw calls this; older versions ignore it.
 clawMessengerPlugin.describeMessageTool = describeClawMessageTool;
 // -- Inbound message handler --
-async function handleInboundMessage(data, accountId, account, ctx) {
+export async function handleInboundMessage(data, accountId, account, ctx) {
     const normalized = normalizeInboundMessage(data);
     if (!normalized.ok) {
         ctx.log?.warn?.(`[${accountId}] Dropping inbound message: ${normalized.reason}`);
@@ -488,7 +488,10 @@ async function handleInboundMessage(data, accountId, account, ctx) {
         agentId: route.agentId,
     });
     const envelopeOptions = runtime.channel.reply.resolveEnvelopeFormatOptions(cfg);
-    const previousTimestamp = runtime.channel.session.readSessionUpdatedAt(storePath, routeSessionKey);
+    const previousTimestamp = runtime.channel.session.readSessionUpdatedAt({
+        storePath,
+        sessionKey: routeSessionKey,
+    });
     const rawBody = text || (allMedia.length > 0 ? "<media:image>" : "");
     if (!rawBody)
         return;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { OpenclawPluginApi } from "openclaw/plugin-sdk";
+import { type OpenclawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 declare const plugin: {
     id: string;
     name: string;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema, } from "openclaw/plugin-sdk/plugin-entry";
 import { Type } from "@sinclair/typebox";
 import { clawMessengerPlugin, getConnectionStatus, getWsClient, createGroup } from "./channel.js";
 import { setRuntime, getRuntime } from "./runtime.js";
@@ -99,7 +99,7 @@ const plugin = {
                 const ws = getWsClient(status.accountId);
                 const diagnostics = ws?.getDiagnostics() ?? { errors: [], connectionLog: [] };
                 const report = {
-                    plugin_version: "0.1.11",
+                    plugin_version: "0.1.15",
                     node_version: process.version,
                     connected: status.connected,
                     server_url: status.serverUrl,

package/dist/outbound/send.js

@@ -1,4 +1,4 @@
-import * as pluginSdk from "openclaw/plugin-sdk";
+import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
 function stripLegacyNamespacePrefix(target) {
     let normalized = target.trim();
     while (normalized.startsWith("claw-messenger:") || normalized.startsWith("linq:")) {
@@ -21,7 +21,7 @@ function fallbackNormalizeE164(input) {
     return null;
 }
 function normalizeE164Compat(input) {
-    const sdkNormalize = typeof pluginSdk.normalizeE164 === "function" ? pluginSdk.normalizeE164 : null;
+    const sdkNormalize = typeof normalizeE164 === "function" ? normalizeE164 : null;
     if (sdkNormalize) {
         try {
             return sdkNormalize(input);

package/dist/runtime.d.ts

@@ -1,3 +1,3 @@
-import type { PluginRuntime } from "openclaw/plugin-sdk";
+import type { PluginRuntime } from "openclaw/plugin-sdk/channel-core";
 export declare function setRuntime(next: PluginRuntime): void;
 export declare function getRuntime(): PluginRuntime;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emotion-machine/claw-messenger",
-  "version": "0.1.13",
-  "description": "iMessage, RCS & SMS channel plugin for OpenClaw — no phone or Mac Mini required",
+  "version": "0.1.15",
+  "description": "iMessage, RCS & SMS channel plugin for OpenClaw agents, powered by Claw Messenger, the Mac-free iMessage API for AI agents. Send and receive real texts from Linux, Docker, Windows, or any cloud. No phone or Mac required.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,6 +18,10 @@
     "openclaw",
     "openclaw-plugin",
     "imessage",
+    "imessage-api",
+    "ai-agents",
+    "no-mac",
+    "claw-messenger",
     "rcs",
     "sms",
     "emotion-machine",
@@ -33,7 +37,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
-    "test": "npm run build && node --test tests/*.test.mjs",
+    "test": "npm run build && node --loader ./tests/openclaw-loader.mjs --test tests/*.test.mjs",
     "prepare": "test -d dist || npm run build",
     "prepublishOnly": "npm run clean && npm run build"
   },

package/src/types/openclaw.d.ts

@@ -1,10 +1,10 @@
 /**
- * Type declarations for openclaw/plugin-sdk.
+ * Type declarations for the focused OpenClaw plugin SDK subpaths used here.
  *
  * These are derived from the runtime shapes in openclaw's compiled JS.
- * Since openclaw doesn't ship .d.ts files, we declare the subset we need.
+ * They mirror the subset needed by the plugin without making OpenClaw a runtime dependency.
  */
-declare module "openclaw/plugin-sdk" {
+declare module "openclaw/plugin-sdk/channel-core" {
   import { z } from "zod";
 
   // ── Config ──
@@ -199,7 +199,7 @@ declare module "openclaw/plugin-sdk" {
       };
       session: {
         resolveStorePath(store: any, opts?: { agentId?: string }): string;
-        readSessionUpdatedAt(path: string, sessionKey: string): number | null;
+        readSessionUpdatedAt(ctx: { storePath: string; sessionKey: string }): number | null;
         recordSessionMetaFromInbound(ctx: any): Promise<void>;
         recordInboundSession(ctx: any): void;
         updateLastRoute(ctx: any): void;
@@ -220,7 +220,14 @@ declare module "openclaw/plugin-sdk" {
     [key: string]: any;
   }
 
-  // ── Plugin API ──
+}
+
+declare module "openclaw/plugin-sdk/plugin-entry" {
+  import type {
+    ChannelPlugin,
+    OpenclawConfig,
+    PluginRuntime,
+  } from "openclaw/plugin-sdk/channel-core";
 
   export interface OpenclawPluginApi {
     id: string;
@@ -246,66 +253,17 @@ declare module "openclaw/plugin-sdk" {
     on(hookName: string, handler: any, opts?: any): void;
   }
 
-  // ── Helpers ──
+  export function emptyPluginConfigSchema(): any;
+}
 
+declare module "openclaw/plugin-sdk/channel-plugin-common" {
   export const DEFAULT_ACCOUNT_ID: string;
   export const PAIRING_APPROVED_MESSAGE: string;
-
-  export function normalizeAccountId(accountId?: string | null): string;
-  export function normalizeE164(input: string): string | null;
   export function buildChannelConfigSchema(schema: any): any;
-  export function emptyPluginConfigSchema(): any;
-  export function getChatChannelMeta(channel: string): any;
   export function formatPairingApproveHint(channel: string): string;
+  export function normalizeAccountId(accountId?: string | null): string;
+}
 
-  export function setAccountEnabledInConfigSection(ctx: {
-    cfg: OpenclawConfig;
-    sectionKey: string;
-    accountId: string;
-    enabled: boolean;
-    allowTopLevel?: boolean;
-  }): OpenclawConfig;
-
-  export function deleteAccountFromConfigSection(ctx: {
-    cfg: OpenclawConfig;
-    sectionKey: string;
-    accountId: string;
-    clearBaseFields?: string[];
-  }): OpenclawConfig;
-
-  export function registerPluginHttpRoute(params: {
-    path: string;
-    pluginId?: string;
-    accountId?: string;
-    source?: string;
-    log?: (msg: string) => void;
-    handler: (req: any, res: any) => Promise<void> | void;
-    registry?: any;
-    fallbackPath?: string;
-  }): () => void;
-
-  export function normalizePluginHttpPath(path?: string, fallback?: string): string | null;
-
-  // ── Ack Reactions ──
-
-  export function resolveAckReaction(cfg: OpenclawConfig, agentId?: string): string | undefined;
-
-  export function shouldAckReaction(params: {
-    scope: string;
-    isDirect: boolean;
-    isGroup: boolean;
-    isMentionableGroup?: boolean;
-    requireMention?: boolean;
-    canDetectMention?: boolean;
-    effectiveWasMentioned?: boolean;
-    shouldBypassMention?: boolean;
-  }): boolean;
-
-  // Config schemas
-  export const IMessageConfigSchema: any;
-  export const TelegramConfigSchema: any;
-  export const DiscordConfigSchema: any;
-  export const SlackConfigSchema: any;
-  export const SignalConfigSchema: any;
-  export const WhatsAppConfigSchema: any;
+declare module "openclaw/plugin-sdk/account-resolution" {
+  export function normalizeE164(input: string): string | null;
 }