n8n-nodes-openclaw

n8n community nodes for the OpenClaw Gateway API.

Control your OpenClaw instance from n8n workflows — manage sessions, send messages, run cron jobs, search the web, execute commands, and more.

Installation

Community Nodes (recommended)

1. Open Settings → Community Nodes in your n8n instance
2. Click Install a community node
3. Enter n8n-nodes-openclaw
4. Click Install

Manual Installation

# In your n8n custom nodes directory
cd ~/.n8n/custom
npm install n8n-nodes-openclaw

Or link from source:

git clone https://github.com/karmaniverous/n8n-nodes-openclaw.git
cd n8n-nodes-openclaw
npm install
npm run build

# Link into n8n
mkdir -p ~/.n8n/custom/node_modules
ln -s "$(pwd)" ~/.n8n/custom/node_modules/n8n-nodes-openclaw

Then restart n8n.

Setup

1. In n8n, go to Settings → Credentials → Add Credential
2. Search for OpenClaw API
3. Enter your:
   • Gateway URL — e.g. http://127.0.0.1:18789
   • Gateway Token — found in your OpenClaw config file under gateway.auth.token

Available Tools

The OpenClaw node exposes 20 tools via a Resource dropdown, each with contextual parameters:

Resource	Description
Agents List	List available agent IDs for spawning sub-agents
Browser	Control a browser — open pages, screenshots, snapshots, click, fill forms
Canvas	Control canvas overlays on paired nodes
Cron	Manage scheduled jobs — list, add, update, remove, run, wake
Execute Command	Run shell commands on the host system
Gateway	Manage the gateway — restart, read/write config, trigger updates
Image	Analyze images with a vision model
Memory Get	Read snippets from agent memory files
Memory Search	Semantically search agent memory
Message	Send, read, edit, delete messages across channels (Slack, Discord, Telegram, etc.)
Nodes	Discover and control paired nodes — notifications, camera, location, commands
Process Manager	Manage running exec sessions — poll, log, write stdin, kill
Session Status	Get session status, usage stats, and set model overrides
Sessions History	Retrieve conversation history for a session
Sessions List	List active sessions with filters
Sessions Send	Send messages into other sessions (cross-session communication)
Sessions Spawn	Spawn background sub-agents in isolated sessions
Text to Speech	Convert text to speech audio
Web Fetch	Fetch and extract readable content from URLs (HTML → markdown)
Web Search	Search the web via Brave Search

Raw Mode

Every resource supports Raw Mode — toggle it on to send arbitrary JSON arguments instead of using the form fields. Useful for edge cases or new parameters not yet in the schema.

CLI Commands Not in the API

The OpenClaw CLI (openclaw) has commands that are not available via the Gateway HTTP API — notably openclaw gateway status, openclaw gateway start, and openclaw gateway stop. These manage the local daemon and require OS-level access.

If you need these in a workflow, use n8n's built-in Execute Command node to run them directly:

openclaw gateway status

The CLI does not currently support JSON output, so you'll need to parse the human-readable text.

Examples

See the examples/ directory for ready-to-import n8n workflow files:

• List Sessions — basic workflow showing session listing
• Send Slack Message — send a message to a Slack channel
• Cron Job Management — list and run cron jobs
• Web Search → Message — search the web and post results to a channel

Import any example via Workflows → Import from File in n8n.

How It Works

This node calls the OpenClaw Gateway's POST /tools/invoke endpoint. Each resource/action combination maps to a tool invocation:

{
  "tool": "sessions_list",
  "args": { "limit": 5, "kinds": ["main", "group"] }
}

The gateway enforces tool policies, authentication, and session context. See the OpenClaw docs for full API details.

Development

git clone https://github.com/karmaniverous/n8n-nodes-openclaw.git
cd n8n-nodes-openclaw
npm install
npm run build
npm test

Project Structure

src/
  credentials/          # OpenClaw API credential type
  nodes/OpenClaw/       # Main node implementation
    OpenClaw.node.ts    # Node class with execute function
    toolSchemas.ts      # Static tool schema loader
    openclaw.svg        # Node icon
tool-schemas/           # JSON schema files for each tool (20 files)
examples/               # Example n8n workflows

Running Tests

npm test                                    # Unit tests
OPENCLAW_TOKEN=<token> npm test             # + integration tests against live gateway

Linting & Type Checking

npm run lint
npm run typecheck
npm run knip          # Unused exports/dependencies check

License

BSD-3-Clause

Links

• OpenClaw — the AI agent framework
• OpenClaw Docs — full documentation
• n8n Community Nodes — how community nodes work