bereach-openclaw 1.5.1 → 1.5.4

package/node_modules/@bereach/tools/src/definitions.ts

@@ -2055,4 +2055,23 @@ export const definitions: ToolDefinition[] = [
       properties: {},
     },
   },
+
+  // ── API Key Setup ────────────────────────────────────────────────
+
+  {
+    name: "bereach_set_api_key",
+    description: "Save the BeReach API key in plugin configuration. Call this when the user provides their API key (starts with brc_). After saving, tell the user to restart the gateway with 'openclaw gateway restart' and start a new chat with /new.",
+    handler: "__set_api_key__",
+    parameters: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "The BeReach API key (must start with brc_)",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
 ];

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach-openclaw",
   "name": "BeReach",
-  "version": "1.5.1",
+  "version": "1.5.4",
   "description": "LinkedIn outreach automation — 75+ tools, hook-based enforcement, dynamic context",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "1.5.1",
+  "version": "1.5.4",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "exports": {

package/skills/bereach/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: bereach
 description: "Automate LinkedIn outreach via BeReach (bereach.ai). Use when: prospecting, engaging posts, scraping engagement, searching LinkedIn, managing inbox, running campaigns, managing invitations, analytics, company pages, Sales Navigator, content engagement, feed monitoring. Requires BEREACH_API_KEY."
-lastUpdatedAt: 1775561761
+lastUpdatedAt: 1775565279
 metadata: { "openclaw": { "requires": { "env": ["BEREACH_API_KEY"] }, "primaryEnv": "BEREACH_API_KEY" } }
 ---
 
@@ -45,13 +45,13 @@ At install or upgrade, set up the workspace with these templates:
 
 When the user provides their BeReach API key (`brc_...`):
 
-1. Tell them to paste this command in chat: `/bereach-set-key brc_THEIR_KEY` (replacing with their actual key)
+1. Call the `bereach_set_api_key` tool with their key
 2. Tell them to restart the gateway: `openclaw gateway restart`
 3. After restart, start a new chat with `/new`
 
 If the user doesn't have a key, direct them to https://bereach.ai/token
 
-**Never** try to set the key via environment variables, auth profiles, or manual config edits. Always use `/bereach-set-key`.
+**Never** use config.patch, environment variables, or manual config edits. Always use the `bereach_set_api_key` tool.
 
 ## Two Modes of Operation
 

package/src/hooks/context.ts

@@ -1015,16 +1015,16 @@ export function registerContextHook(api: any, apiKey: string | undefined, state:
             "IMPORTANT: BeReach plugin is installed but no API key is configured.",
             "",
             "If the user provides their BeReach API key (a string starting with brc_):",
-            "- Tell them to paste this command in chat: /bereach-set-key brc_THEIR_KEY",
-            "- Then restart the gateway: openclaw gateway restart",
+            "- Call the bereach_set_api_key tool with their key",
+            "- Then tell them to restart the gateway: openclaw gateway restart",
             "- Then start a new chat: /new",
             "",
             "If the user has NOT provided a key yet:",
             "- Ask them for their BeReach API key",
             "- They can get one at https://bereach.ai/token",
             "",
-            "The /bereach-set-key command saves the key securely in the plugin config.",
-            "Do NOT suggest environment variables, config.patch, or any other method.",
+            "ALWAYS use the bereach_set_api_key tool to save the key.",
+            "Do NOT use config.patch, environment variables, or any other method.",
           ].join("\n") };
         }
 

package/src/hooks/enforcement.ts

@@ -592,11 +592,14 @@ export function registerEnforcementHook(
     const toolName: string = ctx?.toolName ?? ctx?.name ?? "";
     if (!toolName.startsWith("bereach_")) return;
 
+    // Allow set_api_key and self_upgrade without an API key
+    if (toolName === "bereach_set_api_key" || toolName === "bereach_self_upgrade") return;
+
     // Resolve API key dynamically
     const resolvedKey = api?.pluginConfig?.BEREACH_API_KEY ?? api?.pluginConfig?.apiKey ?? apiKey;
     const key = typeof resolvedKey === "string" && resolvedKey.trim() ? resolvedKey.trim() : undefined;
     if (!key) {
-      return { block: true, blockReason: "BLOCKED: BeReach API key not configured. Set it via /bereach-setup or plugin settings, then restart the gateway." };
+      return { block: true, blockReason: "BLOCKED: BeReach API key not configured. Provide your key so the agent can save it with bereach_set_api_key. Get a key at https://bereach.ai/token" };
     }
 
     const params: Record<string, unknown> = ctx?.params ?? ctx?.input ?? {};

package/src/tools/index.ts

@@ -65,6 +65,9 @@ async function executeApiCall(def: ToolDefinition, params: Record<string, unknow
 
       if (!resp.ok) {
         const errorBody = await resp.text();
+        if (resp.status === 401) {
+          throw new Error(`BeReach API key is invalid or expired (401 Unauthorized). The user should get a valid key at https://bereach.ai/token and set it with: /bereach-set-key brc_NEW_KEY`);
+        }
         throw new Error(`API ${method} ${path} failed (${resp.status}): ${errorBody}`);
       }
 
@@ -124,7 +127,7 @@ export function registerAllTools(api: any, taskType?: string) {
   let skipped = 0;
 
   for (const def of definitions) {
-    if (!def.apiPath && def.handler !== "__self_upgrade__" && def.handler !== "__local__") {
+    if (!def.apiPath && def.handler !== "__self_upgrade__" && def.handler !== "__local__" && def.handler !== "__set_api_key__") {
       console.warn(`[bereach:tools] SKIP ${def.name}: no apiPath defined`);
       continue;
     }
@@ -145,10 +148,28 @@ export function registerAllTools(api: any, taskType?: string) {
           return executeSelfUpgrade();
         }
 
+        if (def.handler === "__set_api_key__") {
+          const key = String(params.apiKey ?? "").trim();
+          if (!key || !key.startsWith("brc_")) {
+            return {
+              content: [{ type: "text" as const, text: JSON.stringify({ success: false, error: "Invalid key format. Must start with brc_. Get your key at https://bereach.ai/token" }) }],
+            };
+          }
+          if (typeof api?.config?.set !== "function") {
+            return {
+              content: [{ type: "text" as const, text: JSON.stringify({ success: false, error: "Config API not available. Set BEREACH_API_KEY as an environment variable instead." }) }],
+            };
+          }
+          api.config.set("plugins.entries.bereach-openclaw.config.BEREACH_API_KEY", key);
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify({ success: true, message: `API key saved (…${key.slice(-6)}). Tell the user to run: openclaw gateway restart, then /new` }) }],
+          };
+        }
+
         const apiKey = resolveApiKey(api);
         if (!apiKey) {
           return {
-            content: [{ type: "text" as const, text: JSON.stringify({ success: false, error: "BEREACH_API_KEY not configured. Set it via /bereach-setup or plugin settings." }) }],
+            content: [{ type: "text" as const, text: JSON.stringify({ success: false, error: "BEREACH_API_KEY not configured. The user should provide their key so you can call bereach_set_api_key. Get a key at https://bereach.ai/token" }) }],
           };
         }