Build and modify Knods visual AI workflows using the OpenClaw Gateway polling protocol. Use when Knods sends polling payloads with fields like messageId/mess...
Handle Knods chat turns that request new flows or edits on a visual canvas. Parse Knods polling payload messages, generate assistant text, and include [KNODS_ACTION]...[/KNODS_ACTION] blocks when the canvas should change.
message as the primary request.history for continuity.message describing node types and action rules.messageId to map all response chunks to the correct message.addNode for single-node additions.addFlow for multi-node workflows or any request requiring edges.[KNODS_ACTION]{"action":"addNode",...}[/KNODS_ACTION][KNODS_ACTION]{"action":"addFlow",...}[/KNODS_ACTION]addFlow, ensure every edge source and target references an existing node id.Output node.Output or through appropriate input/output structure.input_1, image_1, output_1) so follow-up edits are easy./respond for the same messageId.{"messageId":"...","done":true} when complete.[KNODS_ACTION]...[/KNODS_ACTION] inline only when a canvas mutation is intended.ChatGPT, Claude, Gemini, GPTImage, FluxImage, FalAIImage, Veo31Video, WanAnimate, TextInput, ImagePanel, Dictation, Output.initialData only when user intent clearly implies parameters.Output.messageId across all chunk posts for a turn.gw_... token via query parameter token; never require Supabase JWT in this flow.When running a persistent poller service/process:
KNODS_BASE_URL already includes /updates?token=...KNODS_BASE_URL points to connection base and token is supplied separately (KNODS_GATEWAY_TOKEN)/respond from the same connection root as /updates.messageId values and transport errors for debugging.This skill ships the runtime bridge and installer:
scripts/knods_iris_bridge.pyscripts/install_local.shInstall/deploy from the skill folder:
bash /home/rolf/.openclaw/skills/knods/scripts/install_local.sh
The installer deploys:
~/.openclaw/scripts/knods_iris_bridge.py~/.config/systemd/user/knods-iris-bridge.serviceThen runs:
systemctl --user daemon-reloadsystemctl --user enable --now knods-iris-bridge.serviceSet these in ~/.openclaw/.env:
KNODS_BASE_URLKNODS_BASE_URL does not already include ?token=...:
KNODS_GATEWAY_TOKENOPENCLAW_AGENT_ID (default: iris)OPENCLAW_BIN (default: openclaw on PATH)systemctl --user status knods-iris-bridge.servicesystemctl --user restart knods-iris-bridge.servicejournalctl --user -u knods-iris-bridge.service -fAfter changing gateway URL/token env values, restart the running bridge process so it reloads config.
systemctl --user restart <knods-bridge-service>Do not assume env changes are picked up live without restart.
Read references/protocol.md for canonical polling endpoints, payload schemas, and action examples.
ZIP package — ready to use