openclaw-workflowskill 0.2.1 → 0.3.2

package/README.md

@@ -13,53 +13,27 @@ Author, validate, run, and review WorkflowSkill workflows — without leaving th
 2. The agent writes, validates, and test-runs the workflow in chat
 3. Schedule it with cron — runs autonomously, no agent session needed
 
-## What it looks like
-
-> **You:** I want to check Hacker News for AI stories every morning and email me a summary.
->
-> **Agent:** I'll author a WorkflowSkill for that. *(invokes `/workflowskill-author`, writes a SKILL.md, runs `workflowskill_validate`)*
->
-> Validated — 3 steps: `fetch`, `filter`, `email`. Running a test now... *(invokes `workflowskill_run`)*
->
-> Run complete: 4 AI stories found, summary drafted. Ready to schedule — want me to set up a daily cron at 8 AM?
-
-## Workflow Lifecycle
-
-```
-describe workflow in natural language
-    ↓
-/workflowskill-author  (agent writes YAML)
-    ↓
-workflowskill_validate  (catch errors early)
-    ↓
-workflowskill_run  (test run, review RunLog)
-    ↓
-workflowskill_runs  (diagnose failures, iterate)
-    ↓
-cron  (schedule for automated execution)
-```
-
 ## Repositories
 
-| Repo | Description |
-|------|-------------|
-| [workflowskill](https://github.com/matthew-h-cromer/workflowskill) | Specification and reference runtime |
-| **openclaw-workflowskill** (this repo) | OpenClaw plugin — author, validate, run, and review workflows from the agent |
+| Repo                                                               | Description                                                                  |
+| ------------------------------------------------------------------ | ---------------------------------------------------------------------------- |
+| [workflowskill](https://github.com/matthew-h-cromer/workflowskill) | Specification and reference runtime                                          |
+| **openclaw-workflowskill** (this repo)                             | OpenClaw plugin — author, validate, run, and review workflows from the agent |
 
 ## Quick Start
 
 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. Configure Anthropic credentials
-
-The plugin reads your Anthropic API key from OpenClaw's credential store — no `.env` file needed. Make sure an Anthropic auth profile is configured in OpenClaw (`~/.openclaw/agents/main/agent/auth-profiles.json`).
-
 ### 3. Restart the gateway
 
 ```bash
@@ -76,16 +50,46 @@ openclaw skills list
 # → workflowskill-author (user-invocable)
 ```
 
+> **Note:** `workflowskill_llm` uses your Anthropic credentials from the main agent — no separate API key configuration needed.
+
+### 5. Create a workflow
+
+Just tell the agent what you want to automate:
+
+> **You:** I want to check Hacker News for AI stories every morning and email me a summary.
+>
+> **Agent:** I'll author a WorkflowSkill for that. _(invokes `/workflowskill-author`, writes a SKILL.md, runs `workflowskill_validate`)_
+>
+> Validated — 3 steps: `fetch`, `filter`, `email`. Running a test now... _(invokes `workflowskill_run`)_
+>
+> Run complete: 4 AI stories found, summary drafted. Ready to schedule — want me to set up a daily cron at 8 AM?
+
+### 6. Schedule it
+
+Ask the agent to set up a cron job, or add one manually at `~/.openclaw/cron/jobs.json`:
+
+```json
+{
+  "payload": {
+    "kind": "agentTurn",
+    "message": "Run the daily-triage workflow using workflowskill_run\n\nSend results to Slack in the #general channel",
+    "model": "haiku"
+  }
+}
+```
+
+Your agent will use `"model": "haiku"` for cron jobs, ensuring execution is cheap and lightweight.
+
 ## Tools
 
 Registers four tools with the OpenClaw agent:
 
-| Tool | Description |
-|------|-------------|
-| `workflowskill_validate` | Parse and validate a SKILL.md or raw YAML workflow |
-| `workflowskill_run` | Execute a workflow and return a compact run summary |
-| `workflowskill_runs` | List and inspect past run logs |
-| `workflowskill_llm` | Call Anthropic directly for inline LLM reasoning in workflows |
+| Tool                     | Description                                                   |
+| ------------------------ | ------------------------------------------------------------- |
+| `workflowskill_validate` | Parse and validate a SKILL.md or raw YAML workflow            |
+| `workflowskill_run`      | Execute a workflow and return a compact run summary           |
+| `workflowskill_runs`     | List and inspect past run logs                                |
+| `workflowskill_llm`      | Call Anthropic directly for inline LLM reasoning in workflows |
 
 Also ships the `/workflowskill-author` skill — just say "I want to automate X" and the agent handles the rest: researching, writing, validating, and test-running the workflow in chat.
 
@@ -100,22 +104,6 @@ Also ships the `/workflowskill-author` skill — just say "I want to automate X"
     daily-triage-2024-01-15T09-00-00.000Z.json
 ```
 
-## Cron Scheduling
-
-Schedule a workflow to run autonomously via OpenClaw's cron, at `~/.openclaw/cron/jobs.json`:
-
-```json
-{
-  "payload": {
-    "kind": "agentTurn",
-    "message": "Run the daily-triage workflow using workflowskill_run\n\nSend results to Slack in the #general channel",
-    "model": "haiku"
-  }
-}
-```
-
-Always set `"model": "haiku"` — cron runs are lightweight orchestration and don't need a powerful model. Put delivery instructions (e.g. Slack channel) in the cron message, not in the workflow, so workflows stay reusable.
-
 Review past runs via `workflowskill_runs`.
 
 ## Architecture
@@ -134,9 +122,9 @@ The plugin's own four tools (`workflowskill_validate`, `workflowskill_run`, `wor
 
 Parse and validate a SKILL.md or raw YAML workflow.
 
-| Param | Type | Required | Description |
-|-------|------|----------|-------------|
-| `content` | string | yes | SKILL.md text or raw workflow YAML |
+| Param     | Type   | Required | Description                        |
+| --------- | ------ | -------- | ---------------------------------- |
+| `content` | string | yes      | SKILL.md text or raw workflow YAML |
 
 Returns `{ valid, errors[], name, stepCount, stepTypes[] }`.
 
@@ -144,23 +132,23 @@ Returns `{ valid, errors[], name, stepCount, stepTypes[] }`.
 
 Execute a workflow and return a compact run summary. The full RunLog is persisted to `workflow-runs/` and retrievable via `workflowskill_runs` with `run_id`.
 
-| Param | Type | Required | Description |
-|-------|------|----------|-------------|
-| `workflow_name` | string | no* | Name of a skill resolved from skills directories |
-| `content` | string | no* | Inline SKILL.md content (bypasses skill files) |
-| `inputs` | object | no | Override workflow input defaults |
+| Param           | Type   | Required | Description                                      |
+| --------------- | ------ | -------- | ------------------------------------------------ |
+| `workflow_name` | string | no\*     | Name of a skill resolved from skills directories |
+| `content`       | string | no\*     | Inline SKILL.md content (bypasses skill files)   |
+| `inputs`        | object | no       | Override workflow input defaults                 |
 
-*One of `workflow_name` or `content` is required.
+\*One of `workflow_name` or `content` is required.
 
 ### `workflowskill_runs`
 
 List and inspect past run logs.
 
-| Param | Type | Required | Description |
-|-------|------|----------|-------------|
-| `workflow_name` | string | no | Filter by workflow name |
-| `run_id` | string | no | Get full RunLog detail for one run |
-| `status` | string | no | Filter by `"success"` or `"failed"` |
+| Param           | Type   | Required | Description                         |
+| --------------- | ------ | -------- | ----------------------------------- |
+| `workflow_name` | string | no       | Filter by workflow name             |
+| `run_id`        | string | no       | Get full RunLog detail for one run  |
+| `status`        | string | no       | Filter by `"success"` or `"failed"` |
 
 No params → 20 most recent runs (summary view).
 
@@ -168,16 +156,16 @@ No params → 20 most recent runs (summary view).
 
 Call Anthropic directly and return the text response. Uses the API key from OpenClaw's credential store. Useful in workflow `tool` steps when you need inline LLM reasoning.
 
-| Param | Type | Required | Description |
-|-------|------|----------|-------------|
-| `prompt` | string | yes | The prompt to send to the LLM |
-| `model` | string | no | Model alias (`haiku`, `sonnet`, `opus`) or full model ID — omit to use the default |
+| Param    | Type   | Required | Description                                                                        |
+| -------- | ------ | -------- | ---------------------------------------------------------------------------------- |
+| `prompt` | string | yes      | The prompt to send to the LLM                                                      |
+| `model`  | string | no       | Model alias (`haiku`, `sonnet`, `opus`) or full model ID — omit to use the default |
 
 Returns `{ text: string }`.
 
 ## Development
 
-The plugin imports from `workflowskill` (peer dependency), installed from npm. No build step is required for type checking:
+The plugin imports from `workflowskill`, installed from npm. No build step is required for type checking:
 
 ```bash
 npm install

package/index.ts

@@ -9,7 +9,8 @@ import { AUTHORING_SKILL } from 'workflowskill';
 import { validateHandler } from './tools/validate.js';
 import { runHandler } from './tools/run.js';
 import { runsHandler } from './tools/runs.js';
-import { createAdapters, type GatewayConfig } from './lib/adapters.js';
+import { llmHandler } from './tools/llm.js';
+import { createToolAdapter, type GatewayConfig } from './lib/adapters.js';
 
 // ─── OpenClaw plugin API types ─────────────────────────────────────────────
 
@@ -83,7 +84,7 @@ function toContent(result: unknown): { content: TextContent[] } {
 // ─── Plugin entry point ────────────────────────────────────────────────────
 
 export default {
-  id: 'workflowskill',
+  id: 'openclaw-workflowskill',
 
   register(api: PluginApi): void {
     const workspace = api?.config?.agents?.defaults?.workspace;
@@ -104,7 +105,7 @@ export default {
     writeFileSync(join(skillDir, 'SKILL.md'), AUTHORING_SKILL + '\n' + openclawContext, 'utf-8');
 
     const gatewayConfig = buildGatewayConfig(api.config);
-    const adapters = createAdapters(gatewayConfig);
+    const toolAdapter = createToolAdapter(gatewayConfig);
     const { registerTool } = api;
 
     // ── workflowskill_validate ────────────────────────────────────────────
@@ -125,7 +126,7 @@ export default {
         required: ['content'],
       },
       execute: async (_id, params) => {
-        return toContent(await validateHandler(params as { content: string }, adapters.toolAdapter));
+        return toContent(validateHandler(params as { content: string }, toolAdapter));
       },
     });
 
@@ -159,7 +160,7 @@ export default {
           await runHandler(
             params as { workflow_name?: string; content?: string; inputs?: Record<string, unknown> },
             workspace,
-            adapters,
+            toolAdapter,
           ),
         );
       },
@@ -203,14 +204,14 @@ export default {
       },
     });
 
-    // ── workflowskill_llm ─────────────────────────────────────────────────────
+    // ── workflowskill_llm ─────────────────────────────────────────────────
     registerTool({
       name: 'workflowskill_llm',
       description:
-        'Call Anthropic directly and return the text response. ' +
-        'Uses the API key from OpenClaw\'s credential store (~/.openclaw/agents/main/agent/auth-profiles.json). ' +
+        'Call the Anthropic LLM and return { text }. ' +
+        'Uses the API key from OpenClaw\'s credential store. ' +
         'Use in workflow tool steps when you need LLM reasoning inline. ' +
-        'model is optional (haiku / sonnet / opus or full model ID); omit for the default.',
+        'model is optional (haiku / sonnet / opus or full model ID); omit for haiku.',
       parameters: {
         type: 'object',
         properties: {
@@ -220,16 +221,15 @@ export default {
           },
           model: {
             type: 'string',
-            description: 'Model alias or ID. Optional — omit to use the Anthropic default.',
+            description: 'Model alias (haiku/sonnet/opus) or full model ID. Optional.',
           },
         },
         required: ['prompt'],
       },
       execute: async (_id, params) => {
-        const { prompt, model } = params as { prompt: string; model?: string };
-        const result = await adapters.llmAdapter.call(model, prompt);
-        return toContent({ text: result.text });
+        return toContent(await llmHandler(params as { prompt: string; model?: string }));
       },
     });
+
   },
 };

package/lib/adapters.ts

@@ -1,27 +1,8 @@
-// adapters.ts — host-delegating adapters for the OpenClaw plugin.
+// adapters.ts — host-delegating tool adapter for the OpenClaw plugin.
 //
 // Tool steps delegate to the Gateway HTTP API via HostToolAdapter (POST /tools/invoke).
-// LLM steps use AnthropicLLMAdapter with the API key read directly from
-// OpenClaw's credential store at ~/.openclaw/agents/main/agent/auth-profiles.json.
 
-import { readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import type { LLMAdapter, ToolAdapter, ToolDescriptor, ToolResult } from 'workflowskill';
-import { AnthropicLLMAdapter, BuiltinToolAdapter } from 'workflowskill';
-
-// Tools served locally by BuiltinToolAdapter (web.scrape, etc.)
-// These bypass the gateway and run in-process.
-const BUILTIN_TOOL_NAMES = new Set(['web.scrape']);
-
-// Lazy singleton — BuiltinToolAdapter.create() is async so we initialize on first use.
-let _builtinToolsPromise: Promise<BuiltinToolAdapter> | null = null;
-function getBuiltinTools(): Promise<BuiltinToolAdapter> {
-  if (!_builtinToolsPromise) {
-    _builtinToolsPromise = BuiltinToolAdapter.create();
-  }
-  return _builtinToolsPromise as Promise<BuiltinToolAdapter>;
-}
+import type { ToolAdapter, ToolDescriptor, ToolResult } from 'workflowskill';
 
 export interface GatewayConfig {
   baseUrl: string;
@@ -29,11 +10,6 @@ export interface GatewayConfig {
   timeoutMs?: number;
 }
 
-export interface AdapterSet {
-  toolAdapter: ToolAdapter;
-  llmAdapter: LLMAdapter;
-}
-
 // Tools this plugin registers — must not be forwarded to the gateway to prevent infinite recursion.
 const SELF_REFERENCING_TOOLS = new Set([
   'workflowskill_validate',
@@ -116,84 +92,11 @@ export class HostToolAdapter implements ToolAdapter {
 }
 
 /**
- * Read the Anthropic API key from OpenClaw's credential store.
- * Throws a clear error if the file is missing or has no anthropic profile.
- */
-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 ?? {};
-  // Prefer the profile OpenClaw last used successfully for anthropic.
-  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;
-}
-
-/**
- * Create host adapters backed by the Gateway HTTP API.
+ * Create a ToolAdapter backed by the Gateway HTTP API.
  *
  * HostToolAdapter forwards tool steps to the gateway's POST /tools/invoke endpoint.
- * Self-referencing tools (the plugin's own four tools) are blocked to prevent recursion.
- * LLM steps use AnthropicLLMAdapter with the key read from OpenClaw's credential store.
+ * Self-referencing tools (the plugin's own tools) are blocked to prevent recursion.
  */
-export function createAdapters(gatewayConfig: GatewayConfig): AdapterSet {
-  const hostTools = new HostToolAdapter(gatewayConfig);
-  const llmAdapter = new AnthropicLLMAdapter(readAnthropicApiKey());
-
-  const LLM_COMPLETE = 'workflowskill_llm';
-  const LLM_COMPLETE_DESCRIPTOR: ToolDescriptor = {
-    name: LLM_COMPLETE,
-    description: 'Call the host LLM with a prompt; returns { text }.',
-  };
-
-  const toolAdapter: ToolAdapter = {
-    has(toolName: string): boolean {
-      if (toolName === LLM_COMPLETE) return true;
-      if (BUILTIN_TOOL_NAMES.has(toolName)) return true;
-      return hostTools.has(toolName);
-    },
-    async invoke(toolName: string, args: Record<string, unknown>): Promise<ToolResult> {
-      if (toolName === LLM_COMPLETE) {
-        const result = await llmAdapter.call(
-          args.model as string | undefined,
-          args.prompt as string,
-        );
-        return { output: { text: result.text } };
-      }
-      if (BUILTIN_TOOL_NAMES.has(toolName)) {
-        const builtinTools = await getBuiltinTools();
-        return builtinTools.invoke(toolName, args);
-      }
-      return hostTools.invoke(toolName, args);
-    },
-    list(): ToolDescriptor[] {
-      const hostToolList = hostTools.list();
-      return [
-        LLM_COMPLETE_DESCRIPTOR,
-        ...hostToolList.filter((t) => t.name !== LLM_COMPLETE),
-      ];
-    },
-  };
-
-  return {
-    toolAdapter,
-    llmAdapter,
-  };
+export function createToolAdapter(gatewayConfig: GatewayConfig): ToolAdapter {
+  return new HostToolAdapter(gatewayConfig);
 }

package/lib/storage.ts

@@ -53,7 +53,7 @@ export interface RunSummaryEntry {
   duration_ms: number;
   steps_executed: number;
   steps_skipped: number;
-  total_tokens: number;
+  total_duration_ms: number;
   error_message?: string;
 }
 
@@ -87,7 +87,7 @@ export function listRuns(
         duration_ms: log.duration_ms,
         steps_executed: log.summary.steps_executed,
         steps_skipped: log.summary.steps_skipped,
-        total_tokens: log.summary.total_tokens,
+        total_duration_ms: log.summary.total_duration_ms,
         error_message: log.error?.message,
       });
     } catch {

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.1.0",
+  "version": "0.3.1",
   "skills": ["skills/workflowskill-author"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-workflowskill",
-  "version": "0.2.1",
+  "version": "0.3.2",
   "description": "WorkflowSkill plugin for OpenClaw — author, validate, run, and review YAML workflows",
   "type": "module",
   "main": "index.ts",
@@ -35,7 +35,7 @@
     ]
   },
   "dependencies": {
-    "workflowskill": "^0.2.0"
+    "workflowskill": "^0.3.1"
   },
   "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 };
+}

package/tools/run.ts

@@ -5,8 +5,7 @@
 // Returns a compact summary to avoid blowing up the calling agent's context.
 
 import { runWorkflowSkill } from 'workflowskill';
-import type { RunLog, RunSummary } from 'workflowskill';
-import type { AdapterSet } from '../lib/adapters.js';
+import type { RunLog, RunSummary, ToolAdapter } from 'workflowskill';
 import { resolveSkillContent, saveRunLog } from '../lib/storage.js';
 
 export interface RunParams {
@@ -64,7 +63,7 @@ function summarizeRunLog(log: RunLog): RunSummarySuccess | RunSummaryFailed {
 export async function runHandler(
   params: RunParams,
   workspace: string,
-  adapters: AdapterSet,
+  toolAdapter: ToolAdapter,
 ): Promise<RunSummarySuccess | RunSummaryFailed> {
   const { workflow_name, content: inlineContent, inputs = {} } = params;
 
@@ -73,13 +72,10 @@ export async function runHandler(
     content = resolveSkillContent(workspace, workflow_name);
   }
 
-  const { toolAdapter, llmAdapter } = adapters;
-
   const log: RunLog = await runWorkflowSkill({
     content,
     inputs,
     toolAdapter,
-    llmAdapter,
     workflowName: workflow_name ?? 'inline',
   });
 

package/tools/validate.ts

@@ -15,6 +15,6 @@ export interface ValidateResult {
   stepTypes?: string[];
 }
 
-export async function validateHandler(params: ValidateParams, toolAdapter: ToolAdapter): Promise<ValidateResult> {
+export function validateHandler(params: ValidateParams, toolAdapter: ToolAdapter): ValidateResult {
   return validateWorkflowSkill({ content: params.content, toolAdapter });
 }