{"id":49718628,"url":"https://github.com/karmaniverous/n8n-nodes-openclaw","last_synced_at":"2026-05-08T22:13:21.091Z","repository":{"id":339358943,"uuid":"1161413379","full_name":"karmaniverous/n8n-nodes-openclaw","owner":"karmaniverous","description":"n8n community nodes for the OpenClaw Gateway API","archived":false,"fork":false,"pushed_at":"2026-02-19T12:10:24.000Z","size":643,"stargazers_count":15,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T14:50:34.481Z","etag":null,"topics":["ai-agent","automation","gateway","n8n","n8n-community-node-package","openclaw"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/n8n-nodes-openclaw","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/karmaniverous.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-19T04:33:01.000Z","updated_at":"2026-04-05T22:45:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/karmaniverous/n8n-nodes-openclaw","commit_stats":null,"previous_names":["karmaniverous/n8n-nodes-openclaw"],"tags_count":1,"template":false,"template_full_name":"karmaniverous/npm-package-template-ts","purl":"pkg:github/karmaniverous/n8n-nodes-openclaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karmaniverous%2Fn8n-nodes-openclaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karmaniverous%2Fn8n-nodes-openclaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karmaniverous%2Fn8n-nodes-openclaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karmaniverous%2Fn8n-nodes-openclaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karmaniverous","download_url":"https://codeload.github.com/karmaniverous/n8n-nodes-openclaw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karmaniverous%2Fn8n-nodes-openclaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32799456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","automation","gateway","n8n","n8n-community-node-package","openclaw"],"created_at":"2026-05-08T22:13:20.413Z","updated_at":"2026-05-08T22:13:21.085Z","avatar_url":"https://github.com/karmaniverous.png","language":"TypeScript","funding_links":[],"categories":["Skills \u0026 Plugins"],"sub_categories":["Notable Skills \u0026 Plugins"],"readme":"# n8n-nodes-openclaw\n\n[n8n](https://n8n.io/) community nodes for the [OpenClaw](https://github.com/openclaw/openclaw) Gateway API.\n\nControl your OpenClaw instance from n8n workflows — manage sessions, send messages, run cron jobs, search the web, execute commands, and more.\n\n![OpenClaw Node in n8n](https://img.shields.io/badge/n8n-community_node-ff6d5a?logo=n8n)\n[![npm version](https://img.shields.io/npm/v/n8n-nodes-openclaw)](https://www.npmjs.com/package/n8n-nodes-openclaw)\n[![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD--3--Clause-blue.svg)](LICENSE)\n\n## Installation\n\n### Community Nodes (recommended)\n\n1. Open **Settings → Community Nodes** in your n8n instance\n2. Click **Install a community node**\n3. Enter `n8n-nodes-openclaw`\n4. Click **Install**\n\n### Manual Installation\n\n```bash\n# In your n8n custom nodes directory\ncd ~/.n8n/custom\nnpm install n8n-nodes-openclaw\n```\n\nOr link from source:\n\n```bash\ngit clone https://github.com/karmaniverous/n8n-nodes-openclaw.git\ncd n8n-nodes-openclaw\nnpm install\nnpm run build\n\n# Link into n8n\nmkdir -p ~/.n8n/custom/node_modules\nln -s \"$(pwd)\" ~/.n8n/custom/node_modules/n8n-nodes-openclaw\n```\n\nThen restart n8n.\n\n## Setup\n\n1. In n8n, go to **Settings → Credentials → Add Credential**\n2. Search for **OpenClaw API**\n3. Enter your:\n   - **Gateway URL** — e.g. `http://127.0.0.1:18789`\n   - **Gateway Token** — found in your OpenClaw config file under `gateway.auth.token`\n\n## Available Tools\n\nThe OpenClaw node exposes **20 tools** via a Resource dropdown, each with contextual parameters:\n\n| Resource | Description |\n|----------|-------------|\n| **Agents List** | List available agent IDs for spawning sub-agents |\n| **Browser** | Control a browser — open pages, screenshots, snapshots, click, fill forms |\n| **Canvas** | Control canvas overlays on paired nodes |\n| **Cron** | Manage scheduled jobs — list, add, update, remove, run, wake |\n| **Execute Command** | Run shell commands on the host system |\n| **Gateway** | Manage the gateway — restart, read/write config, trigger updates |\n| **Image** | Analyze images with a vision model |\n| **Memory Get** | Read snippets from agent memory files |\n| **Memory Search** | Semantically search agent memory |\n| **Message** | Send, read, edit, delete messages across channels (Slack, Discord, Telegram, etc.) |\n| **Nodes** | Discover and control paired nodes — notifications, camera, location, commands |\n| **Process Manager** | Manage running exec sessions — poll, log, write stdin, kill |\n| **Session Status** | Get session status, usage stats, and set model overrides |\n| **Sessions History** | Retrieve conversation history for a session |\n| **Sessions List** | List active sessions with filters |\n| **Sessions Send** | Send messages into other sessions (cross-session communication) |\n| **Sessions Spawn** | Spawn background sub-agents in isolated sessions |\n| **Text to Speech** | Convert text to speech audio |\n| **Web Fetch** | Fetch and extract readable content from URLs (HTML → markdown) |\n| **Web Search** | Search the web via Brave Search |\n\n### Raw Mode\n\nEvery 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.\n\n## CLI Commands Not in the API\n\nThe 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.\n\nIf you need these in a workflow, use n8n's built-in **Execute Command** node to run them directly:\n\n```\nopenclaw gateway status\n```\n\nThe CLI does not currently support JSON output, so you'll need to parse the human-readable text.\n\n## Examples\n\nSee the [`examples/`](examples/) directory for ready-to-import n8n workflow files:\n\n- **List Sessions** — basic workflow showing session listing\n- **Send Slack Message** — send a message to a Slack channel\n- **Cron Job Management** — list and run cron jobs\n- **Web Search → Message** — search the web and post results to a channel\n\nImport any example via **Workflows → Import from File** in n8n.\n\n## How It Works\n\nThis node calls the OpenClaw Gateway's [`POST /tools/invoke`](https://docs.openclaw.ai) endpoint. Each resource/action combination maps to a tool invocation:\n\n```json\n{\n  \"tool\": \"sessions_list\",\n  \"args\": { \"limit\": 5, \"kinds\": [\"main\", \"group\"] }\n}\n```\n\nThe gateway enforces tool policies, authentication, and session context. See the [OpenClaw docs](https://docs.openclaw.ai) for full API details.\n\n## Development\n\n```bash\ngit clone https://github.com/karmaniverous/n8n-nodes-openclaw.git\ncd n8n-nodes-openclaw\nnpm install\nnpm run build\nnpm test\n```\n\n### Project Structure\n\n```\nsrc/\n  credentials/          # OpenClaw API credential type\n  nodes/OpenClaw/       # Main node implementation\n    OpenClaw.node.ts    # Node class with execute function\n    toolSchemas.ts      # Static tool schema loader\n    openclaw.svg        # Node icon\ntool-schemas/           # JSON schema files for each tool (20 files)\nexamples/               # Example n8n workflows\n```\n\n### Running Tests\n\n```bash\nnpm test                                    # Unit tests\nOPENCLAW_TOKEN=\u003ctoken\u003e npm test             # + integration tests against live gateway\n```\n\n### Linting \u0026 Type Checking\n\n```bash\nnpm run lint\nnpm run typecheck\nnpm run knip          # Unused exports/dependencies check\n```\n\n## License\n\n[BSD-3-Clause](LICENSE)\n\n## Links\n\n- [OpenClaw](https://github.com/openclaw/openclaw) — the AI agent framework\n- [OpenClaw Docs](https://docs.openclaw.ai) — full documentation\n- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/) — how community nodes work\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarmaniverous%2Fn8n-nodes-openclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarmaniverous%2Fn8n-nodes-openclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarmaniverous%2Fn8n-nodes-openclaw/lists"}