Skip to main content
Generated file — do not edit here.
Source: JIGGAI/ClawKitchen / docs/WORKFLOW_VISUAL_EDITOR.md
Commit: 91c806e4ff2380a3a4d2e465499c5ce91b15365f
Edit: https://github.com/JIGGAI/ClawKitchen/blob/91c806e4ff2380a3a4d2e465499c5ce91b15365f/docs/WORKFLOW_VISUAL_EDITOR.md
Overview
ClawKitchen’s workflow visual editor is the primary interface for creating, editing, and managing team workflows. It provides a drag-and-drop interface for building complex automation workflows without writing JSON by hand.
Creating a New Workflow
From Template
- Navigate to your team’s Workflows page
- Click “Add Example Workflow Template”
- Choose from available templates (e.g., “Marketing Content Pipeline”)
- The template is added to your team workspace and opens in the editor
From Scratch
- Navigate to your team’s Workflows page
- Click “Create New Workflow”
- Enter a workflow name and ID
- Click “Create” to open the blank workflow in the editor
Visual Editor Interface
Canvas
The main editing area where you build your workflow graph:
- Drag and drop nodes from the node palette
- Connect nodes by dragging from output ports to input ports
- Pan by dragging empty canvas space
- Zoom using mouse wheel or zoom controls
Node Palette
Located on the left side, organized by category:
- Start/End:
start, end nodes for workflow structure
- Logic:
llm nodes for AI-powered content generation
- Actions:
tool nodes for executing commands and actions
- Media:
media-image, media-video, media-audio for content generation
- Human:
human_approval nodes for manual review steps
- Output:
writeback nodes for saving results
Properties Panel
Located on the right side when a node is selected:
- Basic Settings: Node ID, display name, description
- Configuration: Node-specific settings and parameters
- Input/Output: Configure data flow between nodes
Working with Nodes
Adding Nodes
- Drag from palette: Drag a node type from the left palette onto the canvas
- Quick add: Double-click empty canvas space to open node selection dialog
- Copy/paste: Select existing nodes and use Ctrl+C / Ctrl+V
Configuring Nodes
Select a node to open its properties panel:
LLM Nodes
- Agent Assignment: Choose which team agent executes this node
- Prompt: Either inline prompt text or path to prompt template file
- Model Override: Optional model selection (overrides workflow default)
- Output Format: JSON schema or expected output structure
- Agent Assignment: Choose executing agent
- Tool Selection: Choose from available tools (fs.append, outbound.post, message, etc.)
- Parameters: Configure tool-specific arguments
- Error Handling: Define behavior on tool failure
- Agent Assignment: Choose executing agent
- Media Type: image, video, or audio
- Prompt Source: Inline prompt or upstream node output
- Provider Settings: Auto-discovered from available skills
Human Approval Nodes
- Agent Assignment: Choose approver
- Approval Binding: Select configured approval channel/method
- Instructions: Custom approval prompt text
- Timeout: Optional approval deadline
Connecting Nodes
Create edges between nodes to define execution flow:
- Hover over node to see output ports (small circles on node edges)
- Drag from output port to input port of target node
- Set edge conditions: Choose success, error, or always
- Multiple connections: Nodes can have multiple incoming and outgoing edges
Edge Types
- Success (green): Execute target node only if source succeeds
- Error (red): Execute target node only if source fails
- Always (blue): Execute target node regardless of source outcome
Advanced Features
Template Variables
Use template variables in node configurations:
{{run.id}}: Current workflow run ID{{workflow.id}}: Workflow identifier{{date}}: Current date/time{{upstream_node.output}}: Output from previous nodes
Node Dependencies
Configure complex dependencies in the properties panel:
- Input From: Specify which upstream nodes this node waits for
- Data Binding: Map specific output fields from upstream nodes
- Conditional Logic: Use edge conditions for branching workflows
Workflow Settings
Access via the gear icon in the top toolbar:
- General: Workflow name, description, default model
- Triggers: Configure cron schedules or manual triggers
- Approvals: Set up approval bindings and notification channels
- Variables: Define workflow-level template variables
Workflow Templates
Marketing Content Pipeline
Complete pipeline for content creation and distribution:
- Draft Content (LLM) → Generate marketing copy
- Generate Visuals (Media-Image) → Create supporting images
- Human Review (Approval) → Manual content review
- Publish (Tool) → Post to social media platforms
Documentation Update
Automated documentation maintenance workflow:
- Scan Changes (Tool) → Check for code/feature changes
- Draft Updates (LLM) → Generate documentation updates
- Review (Approval) → Human review and approval
- Commit (Tool) → Update documentation files
Customer Support Escalation
Automated support ticket processing:
- Analyze Ticket (LLM) → Categorize and assess urgency
- Route Decision (branching edges) → Different paths based on priority
- Auto-Response (Tool) → Send initial customer response
- Human Handoff (Approval) → Transfer to human agent if needed
Best Practices
Workflow Design
- Start simple: Begin with linear workflows before adding complexity
- Use descriptive names: Clear node IDs and descriptions improve maintainability
- Add error handling: Include error paths for critical operations
- Document dependencies: Note external requirements in workflow description
Node Configuration
- Test incrementally: Use manual runs to test individual node configurations
- Use templates: Leverage prompt templates for reusable content
- Monitor outputs: Check node output files to debug issues
- Set timeouts: Configure appropriate timeouts for long-running operations
Team Collaboration
- Consistent naming: Establish team conventions for node and workflow naming
- Version control: Workflow files are stored in git for change tracking
- Document workflows: Add descriptions explaining workflow purpose and usage
- Share templates: Create reusable workflow templates for common patterns
Troubleshooting
Common Issues
Node Not Executing
- Check agent assignment is valid
- Verify all required parameters are configured
- Check incoming edge conditions are satisfied
- Review run logs in the Runs page
LLM Node Failures
- Verify llm-task plugin is available
- Check model configuration and availability
- Review prompt template syntax
- Ensure agent has appropriate permissions
Tool Node Errors
- Verify tool availability in current environment
- Check parameter formatting and values
- Review tool-specific documentation
- Test tool independently via CLI
Approval Timeouts
- Check approval binding configuration
- Verify notification delivery
- Review approval channel accessibility
- Consider increasing timeout values
Debugging Workflows
- Use Run Detail pages: Inspect individual run execution
- Check node outputs: Review generated content and data
- Monitor logs: Look for error messages and execution traces
- Test manually: Use “Run Now” to test workflow changes
- Simplify temporarily: Remove complex nodes to isolate issues
Integration Points
With ClawRecipes
- Workflows are stored as
.workflow.json files in team workspace
- Visual editor generates valid ClawRecipes workflow format
- Changes sync automatically with file system
- Compatible with ClawRecipes CLI tools
With Team Management
- Agent assignments use team member definitions
- Approval bindings connect to team communication channels
- Workflow permissions inherit from team access controls
- Shared templates available across team workspaces
- Tool nodes integrate with OpenClaw tool ecosystem
- Media nodes auto-discover available generation skills
- Approval nodes connect to configured messaging platforms
- Output nodes can trigger external webhooks or APIs
This visual editor makes workflow creation accessible while maintaining the power and flexibility of the underlying ClawRecipes format. 