- name
- flowclaw
- version
- 1.1.3
- description
- YAML-driven workflow orchestrator for AI agent teams with human-in-the-loop approval gates. Includes optional Notion, n8n, and Discord integrations.
- platforms
- metadata
- openclaw
- requires
- env
- optionalEnv
FlowClaw
YAML-driven workflow orchestrator for OpenClaw agent teams. Connects Notion → n8n → agents, with approval gates so nothing runs without your go-ahead.
What It Does
FlowClaw is a workflow execution engine that:
- Receives task triggers from n8n (via Notion polling)
- Loads the appropriate YAML workflow definition
- Executes each step by dispatching to specialized AI agents
- Pauses at approval gates and waits for human sign-off
- Reports progress via Discord notifications
Requirements
- Python 3.8+
- OpenClaw with configured agents
- n8n (optional — only needed for n8n-triggered workflows)
- Notion workspace with task database (optional — only needed for Notion sync)
Setup
- Copy
config/example.envto.envand fill in your API keys - Install:
pip3 install -r src/requirements.txt - Start:
python3 src/workflow-executor.py - Import
src/n8n-workflow.jsoninto your n8n instance - Update n8n credential/ID placeholders with your values — see INTEGRATION-STEPS.md
Configuration
All configuration is via environment variables. See config/example.env for the full list.
Key variables:
WORKFLOW_EXECUTOR_API_KEY— API key for authenticating requestsNOTION_API_KEY— Notion integration token (starts withsecret_...)DISCORD_BOT_TOKEN— Discord bot token for notifications (optional)PORT— Server port (default: 8765)MAX_WORKERS— Gunicorn worker count (default: 4, recommended: 2× CPU cores)