@emotion-machine/claw-messenger 0.1.1 → 0.1.3

package/README.md

@@ -10,22 +10,18 @@ openclaw plugins install @emotion-machine/claw-messenger
 
 ## Configuration
 
-After installing, add to your OpenClaw config under `channels`:
+After installing, add to your config under `channels`:
 
 ```json5
 {
   "channels": {
     "claw-messenger": {
-      "accounts": {
-        "default": {
-          "enabled": true,
-          "apiKey": "cm_live_XXXXXXXX_YYYYYYYYYYYYYY",
-          "serverUrl": "wss://claw-messenger.onrender.com",
-          "preferredService": "iMessage",  // "iMessage" | "RCS" | "SMS"
-          "dmPolicy": "pairing",           // "open" | "pairing" | "allowlist"
-          "allowFrom": ["+15551234567"]    // only used with "allowlist" policy
-        }
-      }
+      "enabled": true,
+      "apiKey": "cm_live_XXXXXXXX_YYYYYYYYYYYYYY",
+      "serverUrl": "wss://claw-messenger.onrender.com",
+      "preferredService": "iMessage",  // "iMessage" | "RCS" | "SMS"
+      "dmPolicy": "pairing",           // "open" | "pairing" | "allowlist"
+      "allowFrom": ["+15551234567"]    // only used with "allowlist" policy
     }
   }
 }
@@ -65,4 +61,4 @@ The plugin registers two tools your agent can call:
 
 ## License
 
-UNLICENSED
+UNLICENSED

package/dist/channel.d.ts

@@ -1,7 +1,3 @@
-/**
- * Claw Messenger channel plugin — adapted from channel-linq.
- * All Linq API interaction is replaced by WebSocket communication to claw-messenger.
- */
 import { type ChannelPlugin } from "openclaw/plugin-sdk";
 import { type ClawMessengerConfig } from "./config.js";
 interface ResolvedAccount {
@@ -18,5 +14,10 @@ export declare function getConnectionStatus(): {
     preferredService: string;
     accountId: string;
 };
+export declare function createGroup(to: string[], text: string): Promise<{
+    ok: boolean;
+    messageId: string;
+    chatId: string;
+}>;
 export declare const clawMessengerPlugin: ChannelPlugin<ResolvedAccount>;
 export {};

package/dist/channel.js

@@ -1,7 +1,3 @@
-/**
- * Claw Messenger channel plugin — adapted from channel-linq.
- * All Linq API interaction is replaced by WebSocket communication to claw-messenger.
- */
 import { buildChannelConfigSchema, DEFAULT_ACCOUNT_ID, formatPairingApproveHint, normalizeE164, PAIRING_APPROVED_MESSAGE, } from "openclaw/plugin-sdk";
 import { ClawMessengerConfigSchema } from "./config.js";
 import { getRuntime } from "./runtime.js";
@@ -45,6 +41,19 @@ export function getConnectionStatus() {
         accountId: account.accountId,
     };
 }
+export async function createGroup(to, text) {
+    const runtime = getRuntime();
+    const cfg = runtime.config.loadConfig();
+    const account = resolveAccount(cfg);
+    const ws = wsClients.get(account.accountId);
+    if (!ws)
+        throw new Error("Not connected to claw-messenger");
+    if (!Array.isArray(to) || to.length < 2) {
+        throw new Error("Group requires at least 2 recipients");
+    }
+    const result = await sendToNewGroup(ws, to, text, account.preferredService);
+    return { ok: true, ...result };
+}
 // -- Channel Plugin --
 const meta = {
     label: "Claw Messenger",
@@ -52,7 +61,7 @@ const meta = {
     detailLabel: "Claw Messenger",
     docsPath: "/channels/claw-messenger",
     docsLabel: "claw-messenger",
-    blurb: "iMessage, RCS & SMS without a Mac or Linq account — via shared claw-messenger proxy.",
+    blurb: "iMessage, RCS & SMS without a Mac or a phone number",
     systemImage: "message.fill",
 };
 export const clawMessengerPlugin = {
@@ -149,6 +158,7 @@ export const clawMessengerPlugin = {
             "Use reactions naturally — the way a real person would in iMessage.",
         ],
     },
+    // Legacy API (OpenClaw <2026.3.22): kept for backward compatibility
     actions: {
         listActions: () => ["send", "react"],
         handleAction: async ({ action, params, cfg }) => {
@@ -377,6 +387,19 @@ export const clawMessengerPlugin = {
         },
     },
 };
+// OpenClaw 2026.3.22+ message-action-discovery API.
+// Added as a runtime property because the ChannelPlugin type from older SDK
+// versions doesn't include it. Newer OpenClaw calls this; older versions ignore it.
+clawMessengerPlugin.describeMessageTool = (cfg) => {
+    const account = resolveAccount(cfg);
+    const ws = wsClients.get(account.accountId);
+    const connected = Boolean(ws?.connected);
+    return {
+        actions: connected ? ["send", "react"] : [],
+        capabilities: [],
+        schema: null,
+    };
+};
 // -- Inbound message handler --
 async function handleInboundMessage(data, accountId, account, ctx) {
     const from = data.from;

package/dist/index.js

@@ -1,12 +1,12 @@
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { Type } from "@sinclair/typebox";
-import { clawMessengerPlugin, getConnectionStatus } from "./channel.js";
+import { clawMessengerPlugin, getConnectionStatus, createGroup } from "./channel.js";
 import { setRuntime, getRuntime } from "./runtime.js";
 const VALID_SERVICES = ["iMessage", "RCS", "SMS"];
 const plugin = {
     id: "claw-messenger",
     name: "Claw Messenger",
-    description: "iMessage, RCS & SMS without a Mac or Linq account — via shared claw-messenger proxy",
+    description: "iMessage, RCS & SMS without a Mac or a phone number",
     configSchema: emptyPluginConfigSchema(),
     register(api) {
         setRuntime(api.runtime);
@@ -56,6 +56,32 @@ const plugin = {
                 };
             },
         });
+        api.registerTool({
+            name: "claw_messenger_create_group",
+            label: "Create iMessage/RCS/SMS Group",
+            description: "Create a new group chat and send the first message. Pass an array of E.164 phone numbers (at least 2) and the initial message text. Returns the chatId to use for future messages to this group.",
+            parameters: Type.Object({
+                to: Type.Array(Type.String(), {
+                    description: "Array of E.164 phone numbers (e.g. [\"+12125551234\", \"+14155559876\"])",
+                    minItems: 2,
+                }),
+                text: Type.String({ description: "The initial message to send to the group" }),
+            }),
+            async execute(_toolCallId, params) {
+                const { to, text } = params;
+                try {
+                    const result = await createGroup(to, text);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(result) }],
+                    };
+                }
+                catch (err) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({ ok: false, error: err.message }) }],
+                    };
+                }
+            },
+        });
         // -- Auto-Reply Commands --
         api.registerCommand({
             name: "cm-status",

package/dist/outbound/send.d.ts

@@ -1,7 +1,3 @@
-/**
- * Send messages via WebSocket to claw-messenger -> Linq -> iMessage.
- * Replaces direct Linq API calls from channel-linq/src/outbound/send.ts.
- */
 import type { WsClient } from "../ws/client.js";
 export interface SendResult {
     messageId: string;

package/dist/outbound/send.js

@@ -1,7 +1,3 @@
-/**
- * Send messages via WebSocket to claw-messenger -> Linq -> iMessage.
- * Replaces direct Linq API calls from channel-linq/src/outbound/send.ts.
- */
 export async function sendText(ws, to, text, service) {
     return sendMessage(ws, to, [{ type: "text", value: text }], service);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emotion-machine/claw-messenger",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "iMessage, RCS & SMS channel plugin for OpenClaw — no phone or Mac Mini required",
   "type": "module",
   "main": "dist/index.js",