openclaw-workflowskill 0.3.3 → 0.4.0

package/README.md

@@ -26,7 +26,11 @@ Requires [OpenClaw](https://openclaw.ai).
 
 ### 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/).
+```bash
+openclaw config set tools.profile 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
 
@@ -41,7 +45,7 @@ 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).
+The first command allowlists the plugin so the gateway loads it. The second makes its tools available in every session — including cron jobs — so agents can invoke `workflowskill_run` to execute workflows autonomously.
 
 ### 4. Restart the gateway
 
@@ -49,6 +53,8 @@ The first command allowlists the plugin for loading. The second makes its tools
 openclaw gateway restart
 ```
 
+The gateway loads plugins and config at startup. A restart is required to pick up the plugin installation and config changes from the previous steps.
+
 ### 5. Verify
 
 ```bash
@@ -131,7 +137,7 @@ Workflow `tool` steps are forwarded to the **OpenClaw gateway** via `POST /tools
 
 The `workflowskill_llm` tool is built-in: it calls Anthropic directly using the API key from OpenClaw's credential store, and is always available.
 
-The plugin's own four tools (`workflowskill_validate`, `workflowskill_run`, `workflowskill_runs`, `workflowskill_llm`) are blocked from being forwarded to the gateway to prevent infinite recursion.
+Only `workflowskill_run` is blocked from gateway forwarding — it is self-referencing and would create infinite recursion. The other three plugin tools (`workflowskill_validate`, `workflowskill_runs`, `workflowskill_llm`) are leaf operations and are forwarded normally.
 
 ## Tool Reference
 
@@ -178,7 +184,7 @@ Call Anthropic directly and return the text response. Uses the API key from Open
 | `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 }`.
+Returns the LLM response as a plain text string.
 
 ## Development
 

package/index.ts

@@ -208,7 +208,7 @@ export default {
     registerTool({
       name: 'workflowskill_llm',
       description:
-        'Call the Anthropic LLM and return { text }. ' +
+        'Call the Anthropic LLM and return the response as plain 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 haiku.',

package/lib/adapters.ts

@@ -4,18 +4,30 @@
 
 import type { ToolAdapter, ToolDescriptor, ToolResult } from 'workflowskill';
 
+/** Unwrap MCP text-content envelope so workflows see actual tool output. */
+function unwrapMcpContent(body: unknown): unknown {
+  if (body !== null && typeof body === 'object' && 'content' in body) {
+    const { content } = body as { content: unknown };
+    if (Array.isArray(content) && content.length === 1
+      && content[0]?.type === 'text' && typeof content[0]?.text === 'string') {
+      try { return JSON.parse(content[0].text); }
+      catch { return content[0].text; }
+    }
+  }
+  return body;
+}
+
 export interface GatewayConfig {
   baseUrl: string;
   token: string;
   timeoutMs?: number;
 }
 
-// Tools this plugin registers — must not be forwarded to the gateway to prevent infinite recursion.
+// Only workflowskill_run is truly recursive — a workflow step calling it
+// would launch another workflow with the same adapter, risking infinite loops.
+// The other plugin tools (validate, runs, llm) are leaf operations and safe.
 const SELF_REFERENCING_TOOLS = new Set([
-  'workflowskill_validate',
   'workflowskill_run',
-  'workflowskill_runs',
-  'workflowskill_llm',
 ]);
 
 /** ToolAdapter that delegates to the Gateway HTTP API via POST /tools/invoke. */
@@ -62,7 +74,7 @@ export class HostToolAdapter implements ToolAdapter {
 
     if (response.status === 200) {
       const result = (await response.json()) as unknown;
-      return { output: result };
+      return { output: unwrapMcpContent(result) };
     }
     if (response.status === 404) {
       return { output: null, error: `Tool '${toolName}' not found or blocked by the gateway.` };

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-workflowskill",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "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.2"
+    "workflowskill": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",
@@ -44,7 +44,6 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit --project tsconfig.json",
-    "reset": "bash scripts/reset.sh",
     "prepublishOnly": "tsc --noEmit --project tsconfig.json"
   }
 }

package/tools/llm.ts

@@ -9,10 +9,6 @@ export interface LlmParams {
   model?: string;
 }
 
-export interface LlmResult {
-  text: string;
-}
-
 const MODEL_ALIASES: Record<string, string> = {
   haiku: 'claude-haiku-4-5-20251001',
   sonnet: 'claude-sonnet-4-6',
@@ -73,9 +69,8 @@ async function callAnthropic(apiKey: string, model: string, prompt: string): Pro
   return data.content.find((b) => b.type === 'text')?.text ?? '';
 }
 
-export async function llmHandler(params: LlmParams): Promise<LlmResult> {
+export async function llmHandler(params: LlmParams): Promise<string> {
   const { prompt, model = DEFAULT_MODEL } = params;
   const apiKey = readAnthropicApiKey();
-  const text = await callAnthropic(apiKey, model, prompt);
-  return { text };
+  return callAnthropic(apiKey, model, prompt);
 }