Skip to content

KNQuoc/jammed-claw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jammed-claw 🦀⚡

Visual workflow automation for OpenClaw — powered by jam-nodes.

AI builds the workflow. The engine runs it deterministically.

What is this?

jammed-claw connects jam-nodes (a visual workflow framework) to OpenClaw (an AI agent platform). The result:

  • Describe what you want automated in plain English
  • AI creates a structured workflow (nodes + edges + config)
  • Engine executes it deterministically — no tokens burned on repeated runs
  • Schedule it to run on cron, triggers, or manual invocation
"Every morning, search for AI news, summarize it, and send it to Discord"

    ┌──────────────┐     ┌──────────┐     ┌──────────────┐
    │  web-search   │────▶│   llm    │────▶│   message    │
    │ "AI news today"│     │ summarize │     │  → #general  │
    └──────────────┘     └──────────┘     └──────────────┘

Runs every day at 8am. Zero AI cost after creation.

Features

🔌 OpenClaw Nodes

Custom jam-nodes that map to OpenClaw's tool infrastructure:

Node Description
openclaw-web-search Brave Search API
openclaw-web-fetch Fetch & extract content from URLs
openclaw-exec Run shell commands
openclaw-message Send messages (Discord, Telegram, Slack, etc.)
openclaw-llm Call AI models (Claude, GPT, etc.)
openclaw-memory Read/write memory files
openclaw-cron Schedule workflow runs
openclaw-browser Browser automation
openclaw-conditional Branch based on conditions
openclaw-transform Map, filter, reshape data

🏃 Workflow Runner

Executes jam-nodes workflows using OpenClaw's tools:

  • Topological sort for correct execution order
  • Data flows between nodes via typed ports
  • Conditional branching and error handling
  • Real-time status callbacks

🧠 AI Workflow Builder

Tools and prompts for OpenClaw agents to create workflows:

  • Natural language → workflow JSON
  • Edit, debug, and clone existing workflows
  • Validates against available node definitions
  • Suggests optimizations

📋 Workflow Manager

Save, list, schedule, and trigger workflows:

  • Store workflows as JSON files
  • Schedule via OpenClaw cron
  • Manual invocation from chat
  • Execution history and logs

Installation

npm install jammed-claw @jam-nodes/core

Quick Start

import { OpenClawRunner, openclawNodes } from 'jammed-claw';
import { NodeRegistry } from '@jam-nodes/core';

// Register OpenClaw nodes
const registry = new NodeRegistry();
openclawNodes.forEach(node => registry.register(node));

// Create runner with OpenClaw tool bridge
const runner = new OpenClawRunner(registry, {
  onStatus: (nodeId, status) => {
    console.log(`${nodeId}: ${status.status}`);
  }
});

// Run a workflow
const result = await runner.run(workflowJSON);

As an OpenClaw Skill

Copy the skill/ folder into your OpenClaw workspace skills directory:

cp -r skill/ ~/.openclaw/workspace/skills/jammed-claw/
mkdir -p ~/.openclaw/workspace/workflows/

Set env vars for the bridge:

export BRAVE_API_KEY=your-key    # for web search node
export OPENAI_API_KEY=your-key   # for LLM node

Then the agent can create and run workflows from chat:

User: "Every hour, check my GitHub notifications and summarize them on Slack"
Agent: Created workflow "GitHub Notification Digest" with 3 nodes. Scheduled hourly. ✅

Run workflows directly:

node ~/.openclaw/workspace/skills/jammed-claw/scripts/run-workflow.mjs ai-news-digest

Architecture

┌─────────────────────────────────────────────┐
│                  OpenClaw                    │
│  ┌──────────┐  ┌──────────┐  ┌───────────┐ │
│  │  Agent    │  │   Cron   │  │  Message   │ │
│  │ (Claude)  │  │ Scheduler│  │  Channels  │ │
│  └────┬─────┘  └────┬─────┘  └─────┬─────┘ │
│       │              │              │        │
│  ┌────▼──────────────▼──────────────▼─────┐ │
│  │           jammed-claw                   │ │
│  │  ┌─────────┐ ┌────────┐ ┌───────────┐  │ │
│  │  │ Builder │ │ Runner │ │  Manager   │  │ │
│  │  └────┬────┘ └───┬────┘ └─────┬─────┘  │ │
│  │       │          │            │         │ │
│  │  ┌────▼──────────▼────────────▼─────┐   │ │
│  │  │     OpenClaw Node Definitions    │   │ │
│  │  │  web-search │ llm │ message │ …  │   │ │
│  │  └──────────────────────────────────┘   │ │
│  └─────────────────────────────────────────┘ │
│                      │                        │
│  ┌───────────────────▼────────────────────┐  │
│  │           @jam-nodes/core              │  │
│  │  Registry │ ExecutionContext │ Types    │  │
│  └────────────────────────────────────────┘  │
└──────────────────────────────────────────────┘

License

MIT

About

Visual workflow automation for OpenClaw — powered by jam-nodes

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors