OpenClaw-inspired autonomous AI agent built entirely in n8n. Adaptive RAG-powered memory, Skills via MCP templates, Expert Agents with delegated sub-agents, proactive task management, media understanding - self-hosted with one setup script
How to install n8n-claw?
freddy-schuetz/n8n-claw
$git clone https://github.com/freddy-schuetz/n8n-clawInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install n8n-claw by running `git clone https://github.com/freddy-schuetz/n8n-claw`, then use it for the current task and follow its documentation at https://github.com/freddy-schuetz/n8n-claw.
README.md
| 1 | <p align="center"> |
| 2 | <img src="social-preview.png" alt="n8n-claw logo" width="600"> |
| 3 | </p> |
| 4 | |
| 5 | # n8n-claw — Self-Hosted AI Agent |
| 6 | |
| 7 | A fully self-hosted AI agent built on n8n + PostgreSQL + Claude. Talks to you via Telegram or HTTP API (Slack, Teams, custom apps), builds its own MCP tools, manages reminders and memory — all running on your own infrastructure. |
| 8 | |
| 9 | **Short Introduction** |
| 10 | |
| 11 | https://github.com/user-attachments/assets/10b7b93d-f482-47c1-a144-80a1b9d1be16 |
| 12 | |
| 13 | ## Contents |
| 14 | |
| 15 | - [What it does](#what-it-does) |
| 16 | - [Architecture](#architecture) |
| 17 | - [Installation](#installation) |
| 18 | - [Services & URLs](#services--urls) |
| 19 | - [Connect Claude Desktop, ChatGPT, Claude Code, Lovable & Cursor](#connect-claude-desktop-chatgpt-claude-code-lovable--cursor) |
| 20 | - [Webhook API & External Integrations](#webhook-api--external-integrations) |
| 21 | - [MCP Skills Library](#mcp-skills-library) |
| 22 | - [Google Services (OAuth2)](#google-services-oauth2) |
| 23 | - [Expert Agents](#expert-agents) |
| 24 | - [OpenClaw Integration](#openclaw-integration) |
| 25 | - [Building custom MCP Skills](#building-custom-mcp-skills) |
| 26 | - [Memory](#memory) |
| 27 | - [Knowledge Graph](#knowledge-graph) |
| 28 | - [Project Memory](#project-memory) |
| 29 | - [Task Management](#task-management) |
| 30 | - [Reminders & Scheduled Actions](#reminders--scheduled-actions) |
| 31 | - [Media Support](#media-support) |
| 32 | - [Heartbeat & Scheduled Actions](#heartbeat--scheduled-actions-1) |
| 33 | - [Customization](#customization) |
| 34 | - [Alternative LLM Providers](#alternative-llm-providers) |
| 35 | - [Switching from Telegram to WhatsApp](#switching-from-telegram-to-whatsapp) |
| 36 | - [HTTPS Setup](#https-setup) |
| 37 | - [Updating](#updating) |
| 38 | - [Postgres 17 Upgrade](#postgres-17-upgrade-existing-installations) |
| 39 | - [Troubleshooting](#troubleshooting) |
| 40 | - [WorkflowBuilder with Claude Code](#optional-workflowbuilder-with-claude-code) |
| 41 | - [Stack](#stack) |
| 42 | |
| 43 | --- |
| 44 | |
| 45 | ## What it does |
| 46 | |
| 47 | Talk to your agent in natural language — it manages tasks, remembers context across conversations, builds API integrations, and proactively keeps you on track. |
| 48 | |
| 49 | - **Telegram chat** — talk to your AI agent directly via Telegram |
| 50 | - **Webhook API** — call the agent from any external system via HTTP (Slack, Teams, Paperclip, custom apps) |
| 51 | - **Enriched long-term memory** — hybrid search (semantic + full-text + entity match, fused via RRF) with time decay, tags, entity tracking, source attribution, and category-based auto-expiry. Finds people by name, survives embedding API outages, naturally prefers recent context. |
| 52 | - **Knowledge graph** — automatically tracks people, companies, products, and events; multi-hop graph traversal reveals how everything connects |
| 53 | - **Task management** — create, track, and complete tasks with priorities and due dates |
| 54 | - **Proactive heartbeat** — automatically reminds you of overdue/urgent tasks |
| 55 | - **Recurring actions** — repeating tasks on any schedule ("check my emails every 15 minutes", "daily briefing at 8am") |
| 56 | - **Smart background checks** — monitoring tasks only notify you when something new is found |
| 57 | - **Failure awareness** — workflow errors are logged to memory and pushed to Telegram. Just ask *"did anything fail today?"* or *"what was the error in the last background check?"* and the agent explains in plain language — no more digging through n8n execution logs |
| 58 | - **Expert agents** — delegate complex tasks to specialized sub-agents (3 included, 100+ available from [agent catalog](https://github.com/freddy-schuetz/n8n-claw-agents) across 12 categories) |
| 59 | - **MCP Skills** — install pre-built skills or build new API integrations on demand |
| 60 | - **Smart reminders** — timed Telegram reminders ("remind me in 2 hours to...") |
| 61 | - **Scheduled actions** — the agent executes instructions at a set time ("search HN for AI news at 9am") |
| 62 | - **Web search** — searches the web via built-in SearXNG instance (no API key needed) |
| 63 | - **Web reader** — reads webpages as clean markdown via Crawl4AI (JS rendering, no boilerplate) |
| 64 | - **Browser automation** — drives a real Chromium via Browser Use to perform agentic actions on websites: newsletter signups, contact forms, click f |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
