openclaw-workflowskill 0.3.1 → 0.3.3

package/README.md

@@ -24,19 +24,32 @@ Author, validate, run, and review WorkflowSkill workflows — without leaving th
 
 Requires [OpenClaw](https://openclaw.ai).
 
-### 1. Install the plugin
+### 1. Set your profile to Coding
+
+In OpenClaw settings, change your profile from `messaging` (the default) to `coding`. The `coding` profile grants the agent filesystem access, which is required to read and write workflow files. For more granular access configuration, refer to the [OpenClaw documentation](https://docs.openclaw.ai/).
+
+### 2. Install the plugin
 
 ```bash
 openclaw plugins install openclaw-workflowskill
 ```
 
-### 2. Restart the gateway
+### 3. Configure
+
+```bash
+openclaw config set plugins.allow '["openclaw-workflowskill"]'
+openclaw config set tools.alsoAllow '["openclaw-workflowskill"]'
+```
+
+The first command allowlists the plugin for loading. The second makes its tools available in all sessions (including cron).
+
+### 4. Restart the gateway
 
 ```bash
 openclaw gateway restart
 ```
 
-### 3. Verify
+### 5. Verify
 
 ```bash
 openclaw plugins list
@@ -48,7 +61,7 @@ openclaw skills list
 
 > **Note:** `workflowskill_llm` uses your Anthropic credentials from the main agent — no separate API key configuration needed.
 
-### 4. Create a workflow
+### 6. Create a workflow
 
 Just tell the agent what you want to automate:
 
@@ -60,7 +73,7 @@ Just tell the agent what you want to automate:
 >
 > Run complete: 4 AI stories found, summary drafted. Ready to schedule — want me to set up a daily cron at 8 AM?
 
-### 5. Schedule it
+### 7. Schedule it
 
 Ask the agent to set up a cron job, or add one manually at `~/.openclaw/cron/jobs.json`:
 
@@ -76,6 +89,14 @@ Ask the agent to set up a cron job, or add one manually at `~/.openclaw/cron/job
 
 Your agent will use `"model": "haiku"` for cron jobs, ensuring execution is cheap and lightweight.
 
+> **Important:** Plugin tools are not available in sessions by default. Before scheduling, ensure `tools.alsoAllow` includes `openclaw-workflowskill`:
+>
+> ```bash
+> openclaw config set tools.alsoAllow '["openclaw-workflowskill"]'
+> ```
+>
+> Without this, cron sessions cannot invoke `workflowskill_run` and will fail silently.
+
 ## Tools
 
 Registers four tools with the OpenClaw agent:
@@ -173,9 +194,12 @@ To test changes, link the plugin locally and restart the OpenClaw gateway:
 ```bash
 openclaw plugins install --link "$(pwd)"
 openclaw gateway restart
-openclaw tools invoke workflowskill_validate '{"content": "..."}'
 ```
 
+Then verify tools work by asking the agent:
+
+> Validate this workflow: `inputs: { url: { type: string } }`
+
 ## License
 
 MIT

package/index.ts

@@ -4,12 +4,12 @@
 // Default-exports an object with id + register(api) per the OpenClaw plugin API.
 
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { AUTHORING_SKILL } from 'workflowskill';
 import { validateHandler } from './tools/validate.js';
 import { runHandler } from './tools/run.js';
 import { runsHandler } from './tools/runs.js';
+import { llmHandler } from './tools/llm.js';
 import { createToolAdapter, type GatewayConfig } from './lib/adapters.js';
 
 // ─── OpenClaw plugin API types ─────────────────────────────────────────────
@@ -81,74 +81,10 @@ function toContent(result: unknown): { content: TextContent[] } {
   return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
 }
 
-// ─── LLM helpers ───────────────────────────────────────────────────────────
-
-const MODEL_ALIASES: Record<string, string> = {
-  haiku: 'claude-haiku-4-5-20251001',
-  sonnet: 'claude-sonnet-4-6',
-  opus: 'claude-opus-4-6',
-};
-const DEFAULT_MODEL = 'claude-haiku-4-5-20251001';
-
-function readAnthropicApiKey(): string {
-  const profilesPath = join(homedir(), '.openclaw', 'agents', 'main', 'agent', 'auth-profiles.json');
-  let parsed: {
-    profiles?: Record<string, { provider?: string; key?: string }>;
-    lastGood?: Record<string, string>;
-  };
-  try {
-    parsed = JSON.parse(readFileSync(profilesPath, 'utf-8')) as typeof parsed;
-  } catch (err) {
-    throw new Error(
-      `WorkflowSkill: could not read OpenClaw auth profiles from ${profilesPath}: ${err instanceof Error ? err.message : String(err)}`,
-    );
-  }
-  const profiles = parsed.profiles ?? {};
-  const lastGoodName = parsed.lastGood?.['anthropic'];
-  const profile = lastGoodName
-    ? profiles[lastGoodName]
-    : Object.values(profiles).find((p) => p.provider === 'anthropic');
-  if (!profile?.key) {
-    throw new Error(
-      `WorkflowSkill: no anthropic profile found in ${profilesPath}. Add a profile with provider "anthropic" and a key.`,
-    );
-  }
-  return profile.key;
-}
-
-const ANTHROPIC_TIMEOUT_MS = 60_000;
-
-async function callAnthropic(apiKey: string, model: string, prompt: string): Promise<string> {
-  const resolvedModel = MODEL_ALIASES[model] ?? model;
-  const response = await fetch('https://api.anthropic.com/v1/messages', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      'x-api-key': apiKey,
-      'anthropic-version': '2023-06-01',
-    },
-    body: JSON.stringify({
-      model: resolvedModel,
-      max_tokens: 8192,
-      messages: [{ role: 'user', content: prompt }],
-    }),
-    signal: AbortSignal.timeout(ANTHROPIC_TIMEOUT_MS),
-  });
-  if (!response.ok) {
-    const body = await response.text().catch(() => '');
-    throw new Error(`Anthropic API error ${response.status}: ${body}`);
-  }
-  const data = (await response.json()) as {
-    content: Array<{ type: string; text: string }>;
-  };
-  const text = data.content.find((b) => b.type === 'text')?.text ?? '';
-  return text;
-}
-
 // ─── Plugin entry point ────────────────────────────────────────────────────
 
 export default {
-  id: 'workflowskill',
+  id: 'openclaw-workflowskill',
 
   register(api: PluginApi): void {
     const workspace = api?.config?.agents?.defaults?.workspace;
@@ -291,10 +227,7 @@ export default {
         required: ['prompt'],
       },
       execute: async (_id, params) => {
-        const { prompt, model = DEFAULT_MODEL } = params as { prompt: string; model?: string };
-        const apiKey = readAnthropicApiKey();
-        const text = await callAnthropic(apiKey, model, prompt);
-        return toContent({ text });
+        return toContent(await llmHandler(params as { prompt: string; model?: string }));
       },
     });
 

package/lib/openclaw-context.md

@@ -25,3 +25,12 @@ Always set `"model": "haiku"` on cron payloads — cron runs are lightweight orc
   }
 }
 ```
+
+> **Important:** Plugin tools are not available in sessions by default.
+> Before scheduling, ensure `tools.alsoAllow` includes `openclaw-workflowskill`:
+>
+> ```bash
+> openclaw config set tools.alsoAllow '["openclaw-workflowskill"]'
+> ```
+>
+> Without this, cron sessions cannot invoke `workflowskill_run` and will fail silently.

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
-  "id": "workflowskill",
+  "id": "openclaw-workflowskill",
   "name": "WorkflowSkill",
   "description": "Author, validate, run, and review WorkflowSkill YAML workflows",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "skills": ["skills/workflowskill-author"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-workflowskill",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "WorkflowSkill plugin for OpenClaw — author, validate, run, and review YAML workflows",
   "type": "module",
   "main": "index.ts",
@@ -35,7 +35,7 @@
     ]
   },
   "dependencies": {
-    "workflowskill": "^0.3.1"
+    "workflowskill": "^0.3.2"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",

package/tools/llm.ts

@@ -0,0 +1,81 @@
+// workflowskill_llm — call Anthropic LLM using OpenClaw's credential store.
+
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+export interface LlmParams {
+  prompt: string;
+  model?: string;
+}
+
+export interface LlmResult {
+  text: string;
+}
+
+const MODEL_ALIASES: Record<string, string> = {
+  haiku: 'claude-haiku-4-5-20251001',
+  sonnet: 'claude-sonnet-4-6',
+  opus: 'claude-opus-4-6',
+};
+const DEFAULT_MODEL = 'claude-haiku-4-5-20251001';
+const ANTHROPIC_TIMEOUT_MS = 60_000;
+
+function readAnthropicApiKey(): string {
+  const profilesPath = join(homedir(), '.openclaw', 'agents', 'main', 'agent', 'auth-profiles.json');
+  let parsed: {
+    profiles?: Record<string, { provider?: string; key?: string }>;
+    lastGood?: Record<string, string>;
+  };
+  try {
+    parsed = JSON.parse(readFileSync(profilesPath, 'utf-8')) as typeof parsed;
+  } catch (err) {
+    throw new Error(
+      `WorkflowSkill: could not read OpenClaw auth profiles from ${profilesPath}: ${err instanceof Error ? err.message : String(err)}`,
+    );
+  }
+  const profiles = parsed.profiles ?? {};
+  const lastGoodName = parsed.lastGood?.['anthropic'];
+  const profile = lastGoodName
+    ? profiles[lastGoodName]
+    : Object.values(profiles).find((p) => p.provider === 'anthropic');
+  if (!profile?.key) {
+    throw new Error(
+      `WorkflowSkill: no anthropic profile found in ${profilesPath}. Add a profile with provider "anthropic" and a key.`,
+    );
+  }
+  return profile.key;
+}
+
+async function callAnthropic(apiKey: string, model: string, prompt: string): Promise<string> {
+  const resolvedModel = MODEL_ALIASES[model] ?? model;
+  const response = await fetch('https://api.anthropic.com/v1/messages', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+    },
+    body: JSON.stringify({
+      model: resolvedModel,
+      max_tokens: 8192,
+      messages: [{ role: 'user', content: prompt }],
+    }),
+    signal: AbortSignal.timeout(ANTHROPIC_TIMEOUT_MS),
+  });
+  if (!response.ok) {
+    const body = await response.text().catch(() => '');
+    throw new Error(`Anthropic API error ${response.status}: ${body}`);
+  }
+  const data = (await response.json()) as {
+    content: Array<{ type: string; text: string }>;
+  };
+  return data.content.find((b) => b.type === 'text')?.text ?? '';
+}
+
+export async function llmHandler(params: LlmParams): Promise<LlmResult> {
+  const { prompt, model = DEFAULT_MODEL } = params;
+  const apiKey = readAnthropicApiKey();
+  const text = await callAnthropic(apiKey, model, prompt);
+  return { text };
+}