@laburen/openclaw-plugin-whatsapp-api 0.6.0 → 0.6.1

package/README.md

@@ -120,6 +120,19 @@ Responses: **`403`** if the shared secret does not match, **`400`** if the paylo
 
 Per-account fields can override phone id, token, retries, etc. under `channels["whatsapp-api"].accounts.<accountId>`.
 
+## LLM Usage Forwarding (`llm_output`) (opcional)
+
+Este plugin puede reenviar el usage de tokens cuando OpenClaw emite el hook `llm_output`. Cuando está configurado, hace un `POST` a `{LABUREN_WEB_APP_URL}/api/usage` y envía `Authorization: Bearer <laburenApiKey>`.
+
+Para activarlo, configura estas keys del entry del plugin (no del channel):
+
+```bash
+openclaw config set plugins.entries.whatsapp-api.LABUREN_WEB_APP_URL "https://tu-laburen.example"
+openclaw config set plugins.entries.whatsapp-api.userPhoneNumber "+1234567890"
+openclaw config set plugins.entries.whatsapp-api.laburenApiKey "tu-api-key"
+openclaw gateway restart
+```
+
 ## Notes
 
 - Outbound mode is **direct-to-Meta** only (no third-party relay in this plugin).

package/index.js

@@ -1429,6 +1429,7 @@ const log$3 = waLogger("llm-output/forward-usage");
 /** Plugin extension config keys (see `openclaw.plugin.json`). */
 const LABUREN_WEB_APP_CONFIG_KEY = "LABUREN_WEB_APP_URL";
 const USER_PHONE_CONFIG_KEY = "userPhoneNumber";
+const LABUREN_API_KEY_CONFIG_KEY = "laburenApiKey";
 const USAGE_PATH = "/api/usage";
 const USAGE_FEATURE = "openclaw_run";
 const POST_TIMEOUT_MS = 3e3;
@@ -1460,6 +1461,17 @@ function resolveUserPhoneNumber() {
 	const phone = raw.trim();
 	return phone.length > 0 ? phone : null;
 }
+function resolveLaburenApiKey() {
+	let raw;
+	try {
+		raw = getPluginApi().pluginConfig?.[LABUREN_API_KEY_CONFIG_KEY];
+	} catch {
+		return null;
+	}
+	if (typeof raw !== "string") return null;
+	const key = raw.trim();
+	return key.length > 0 ? key : null;
+}
 async function handleForwardLlmUsage(event, ctx) {
 	const usage = event.usage;
 	if (!usage) return;
@@ -1467,6 +1479,11 @@ async function handleForwardLlmUsage(event, ctx) {
 	if (!endpoint) return;
 	const userPhoneNumber = resolveUserPhoneNumber();
 	if (!userPhoneNumber) return;
+	const laburenApiKey = resolveLaburenApiKey();
+	if (!laburenApiKey) {
+		log$3.warn(`usage-forwarder: missing ${LABUREN_API_KEY_CONFIG_KEY} (required for authenticated /api/usage calls)`);
+		return;
+	}
 	const input = usage.input ?? 0;
 	const output = usage.output ?? 0;
 	const cacheRead = usage.cacheRead ?? 0;
@@ -1493,7 +1510,10 @@ async function handleForwardLlmUsage(event, ctx) {
 	try {
 		const res = await fetch(endpoint, {
 			method: "POST",
-			headers: { "Content-Type": "application/json" },
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${laburenApiKey}`
+			},
 			body: JSON.stringify(body),
 			signal: AbortSignal.timeout(POST_TIMEOUT_MS)
 		});

package/openclaw.plugin.json

@@ -17,6 +17,10 @@
         "type": "string",
         "description": "WhatsApp user phone (E.164 or your normalised form). Sent on each usage POST so the backend can resolve the user."
       },
+      "laburenApiKey": {
+        "type": "string",
+        "description": "Bearer token for the Laburen usage ingest API (sent as `Authorization: Bearer <laburenApiKey>` on POST {base}/api/usage)."
+      },
       "defaults": {
         "type": "object",
         "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laburen/openclaw-plugin-whatsapp-api",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "WhatsApp API channel plugin for OpenClaw",
   "main": "index.js",