bereach-openclaw 1.5.0 → 1.5.1-beta.2

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach-openclaw",
   "name": "BeReach",
-  "version": "1.5.0",
+  "version": "1.5.1-beta.2",
   "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.0",
+  "version": "1.5.1-beta.2",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "exports": {
@@ -47,14 +47,14 @@
   ],
   "dependencies": {
     "@bereach/tools": "*",
-    "bereach": "1.5.0"
+    "bereach": "^1.5.0"
   },
   "devDependencies": {
+    "@playwright/test": "^1.52.0",
     "@types/node": "^25.5.0",
     "@upstash/box": "^0.1.30",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",
-    "@playwright/test": "^1.52.0",
     "vitest": "^4.1.2",
     "zod": "^4.3.6"
   }

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: 1775513814
+lastUpdatedAt: 1775561761
 metadata: { "openclaw": { "requires": { "env": ["BEREACH_API_KEY"] }, "primaryEnv": "BEREACH_API_KEY" } }
 ---
 
@@ -41,6 +41,18 @@ At install or upgrade, set up the workspace with these templates:
 
 **Step 0 (mandatory at install/upgrade):** Check if SOUL.md contains `<!-- bereach-workspace-v`. If missing: fetch soul-template.md from the URL above (or via `GET /api/onboarding/soul`), write it into the user's SOUL.md between the markers. This step cannot be skipped.
 
+## API Key Setup
+
+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)
+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`.
+
 ## Two Modes of Operation
 
 ### Interactive Mode

package/src/commands/index.ts

@@ -5,6 +5,22 @@ export function registerCommands(api: any, state?: SessionState, apiKey?: string
   if (typeof api?.registerCommand !== "function") return;
   const resolvedKey = apiKey ?? "";
 
+  api.registerCommand({
+    name: "bereach-set-key",
+    description: "Save your BeReach API key (brc_...) to plugin config",
+    handler: async (_args: string) => {
+      const key = _args?.trim();
+      if (!key || !key.startsWith("brc_")) {
+        return { text: "Invalid key. Your BeReach API key must start with `brc_`. Get it at https://bereach.ai/token" };
+      }
+      if (typeof api?.config?.set !== "function") {
+        return { text: "Cannot save key: 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 { text: `API key saved (…${key.slice(-6)}). Restart the gateway to apply:\n\`openclaw gateway restart\`` };
+    },
+  });
+
   api.registerCommand({
     name: "bereach-credits",
     description: "Show current BeReach credit balance",

package/src/hooks/context.ts

@@ -1011,7 +1011,21 @@ export function registerContextHook(api: any, apiKey: string | undefined, state:
         const resolvedKey = api?.pluginConfig?.BEREACH_API_KEY ?? api?.pluginConfig?.apiKey ?? apiKey;
         const key = typeof resolvedKey === "string" && resolvedKey.trim() ? resolvedKey.trim() : undefined;
         if (!key) {
-          return { appendSystemContext: "BeReach plugin is installed but API key is not configured. Ask the user to set it via /bereach-setup or plugin settings." };
+          return { appendSystemContext: [
+            "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",
+            "- 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.",
+          ].join("\n") };
         }
 
         // Detect task mode

package/src/index.ts

@@ -53,13 +53,7 @@ export default function register(api: any) {
 
   const apiKey = resolveApiKey(api);
   if (!apiKey) {
-    log("WARNING: BEREACH_API_KEY is not configured. Set it via plugin settings.");
-    if (typeof api?.injectContext === "function") {
-      api.injectContext({
-        key: "bereach-warning",
-        content: "BeReach plugin is installed but BEREACH_API_KEY is not configured. Set it via plugin settings to enable LinkedIn automation.",
-      });
-    }
+    log("WARNING: BEREACH_API_KEY is not configured. Setup instructions injected via before_prompt_build hook.");
   }
 
   const config: Partial<PluginConfig> = {