내 PC/서버에 직접 설치해 텔레그램·디스코드로 제어하는 셀프호스팅 AI 에이전트 플랫폼입니다.
외부 서버 없이 로컬 환경에서 Claude, GPT 등 LLM을 연결해 나만의 AI 직원을 구성할 수 있습니다.
이메일이 오면 AI가 내용을 분석하고, 노션(Notion)에 요약본을 정리한 뒤, 슬랙(Slack)으로 알림까지 보내게 만들고 싶으신가요? OpenClaw가 자체적으로 지원하는 스킬만으로는 세상의 모든 앱을 연결하기가 어렵습니다. 이 아쉬움을 단번에 해결해 줄 마법의 오픈소스 도구가 바로 n8n입니다.
이번 28편에서는 openclaw n8n 연동을 처음부터 끝까지 다룹니다. n8n을 배관(Plumbing) 역할로, OpenClaw를 두뇌(Brain) 역할로 결합하여 500개가 넘는 외부 앱들을 AI로 통제하는 초자동화(Hyper-automation) 파이프라인을 완성합니다. 완전 무료로, 데이터는 외부로 한 글자도 유출되지 않습니다.
지난 편(이전: Docker로 OpenClaw 컨테이너 운영하기 — 완전 격리 환경 구축)에서는 Docker로 AI를 격리된 샌드박스에서 안전하게 운영하는 방법을 마스터했습니다.
왜 n8n + OpenClaw 조합이 최강인가? — 완벽한 역할 분담과 비용 제로
n8n(Nodemation)은 Zapier나 Make(구 Integromat)와 같은 노코드(No-code) 워크플로우 자동화 도구입니다. openclaw 설치 환경에 n8n을 함께 구축(Self-hosted n8n)하면 강력한 시너지가 탄생합니다.
- 완벽한 역할 분담: n8n은 외부 앱과의 데이터 연결·전달을 담당하는 '배관(Plumbing)' 역할을, OpenClaw는 데이터를 분석하고 판단하는 '두뇌(Brain)' 역할을 맡습니다. 각자 가장 잘하는 것을 하는 최적의 분업 구조입니다.
- 비용 제로, 데이터 프라이버시 100%: Zapier는 워크플로우 실행 횟수마다 과금이 발생하지만, 개인 서버에서 n8n과 OpenClaw가
localhost로 통신하면 아무리 많은 데이터를 처리해도 요금이 0원이며, 데이터가 외부로 단 한 글자도 유출되지 않습니다. - 500개+ 앱 연결: n8n은 구글 시트, Gmail, Notion, Slack, GitHub, Telegram, 각종 API까지 500개가 넘는 서비스와 연동됩니다. OpenClaw가 이 모든 앱의 두뇌가 됩니다.
docker run -d --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n. 설치 후 브라우저에서 http://localhost:5678로 접속하면 시각적인 워크플로우 편집 화면이 열립니다.n8n → OpenClaw 호출하기 — Webhook 이벤트를 AI에게 분석 의뢰하는 방법
가장 흔한 시나리오는 "외부 시스템에서 이벤트가 발생하면(n8n), AI가 판단하게(OpenClaw) 만드는 것"입니다. n8n 대시보드에서 HTTP Request 노드를 생성하여 OpenClaw 서버 API로 데이터를 전송하도록 설정합니다. 보안을 위해 이전 23편에서 설정했던 인증 토큰을 반드시 헤더에 포함해야 합니다.
n8n HTTP Request 노드 설정값
- Method:
POST - URL:
http://localhost:18789/v1/messages(서버 IP·포트에 맞게 수정) - Headers:
Authorization: Bearer YOUR_SUPER_SECRET_TOKEN,Content-Type: application/json
Body(JSON) 예시 — 이메일 내용 분석 요청
{
"channel": "api",
"text": "새로운 이메일이 도착했습니다. 내용을 요약하고 긴급도를 상/중/하로 분류해 줘: {{ $json.email_body }}"
}이렇게 설정하면 n8n이 이메일, 폼(Form) 응답, 결제 알림 등을 감지할 때마다 OpenClaw에게 메시지를 보내고, AI의 답변을 받아 다음 노드(구글 시트 저장, 슬랙 알림 등)로 전달할 수 있습니다.
{{ $json.필드명 }} 표현식으로 이전 노드에서 전달받은 데이터를 OpenClaw 메시지 본문에 동적으로 삽입할 수 있습니다. 이를 활용하면 이메일 내용, 주문 정보, 센서 데이터 등 어떤 데이터든 AI에게 실시간으로 전달하여 분석을 요청할 수 있습니다.OpenClaw → n8n 워크플로우 트리거하기 — AI가 앱을 직접 조종하는 단계별 가이드
반대 방향도 가능합니다. 텔레그램 채팅창에서 "이 내용 노션에 정리해 줘"라고 지시하면 OpenClaw가 n8n의 특정 워크플로우를 자동으로 실행시킵니다. 25편에서 배웠던 커스텀 툴(Custom Tool) 작성법을 응용하여 n8n의 Webhook URL로 신호를 보내는 파이썬 스크립트를 만들어 보겠습니다.
- n8n에서 Webhook 트리거 노드 생성n8n 대시보드에서 새 워크플로우를 만들고 Webhook 노드를 첫 번째 트리거로 설정합니다. 노드가 생성되면 고유한 Webhook URL이 발급됩니다. 이 URL을 복사해 두세요.
- 커스텀 툴 폴더 및 파이썬 스크립트 생성OpenClaw 워크스페이스에 n8n으로 신호를 보내는 파이썬 스크립트를 작성합니다.
# 커스텀 툴 폴더 생성 mkdir -p ~/.openclaw/workspace/skills/trigger-n8n cd ~/.openclaw/workspace/skills/trigger-n8n # 파이썬 실행 스크립트 생성 cat << 'EOF' > run_n8n.py import sys import json import urllib.request def trigger_webhook(payload): # n8n에서 생성한 Webhook URL을 입력하세요 n8n_url = "http://your-n8n-server.com/webhook/openclaw-trigger" req = urllib.request.Request(n8n_url, method="POST") req.add_header('Content-Type', 'application/json') data = json.dumps({"ai_data": payload}).encode('utf-8') try: with urllib.request.urlopen(req, data=data) as response: print("n8n workflow triggered successfully!") except Exception as e: print(f"Error triggering n8n: {str(e)}") if __name__ == "__main__": if len(sys.argv) > 1: trigger_webhook(sys.argv[1]) else: print("Usage: python run_n8n.py ''") EOF- SKILL.md 파일 작성 — AI에게 스킬 사용법 안내같은 폴더에
SKILL.md파일을 만들어 AI가 언제 이 스크립트를 실행해야 하는지 명확하게 지시합니다. cat << 'EOF' > SKILL.md # trigger-n8n 사용자가 워크플로우 실행, 노션 정리, 슬랙 전송, 외부 앱 연동을 요청하면 이 스킬을 exec 툴로 실행합니다. 실행 방법: python run_n8n.py '<전달할 데이터>' EOF- OpenClaw 재시작 및 테스트게이트웨이를 재시작하면 새 스킬이 자동으로 인식됩니다. 텔레그램에서 "오늘 회의 내용 노션에 정리해 줘"라고 입력하면 AI가 스크립트를 실행하여 n8n 워크플로우를 트리거합니다!
openclaw gateway restart
실전 자동화 시나리오 — 이메일 분석·노션 정리·슬랙 알림 파이프라인
이제 배운 내용을 결합하여 실제로 유용한 자동화 파이프라인 시나리오를 구성해 보겠습니다. 아래는 가장 많이 활용되는 세 가지 예시입니다.
시나리오 1: 이메일 자동 분류·요약 파이프라인
Gmail에 새 이메일 수신(n8n Gmail 트리거) → OpenClaw HTTP Request로 내용 전달 → AI가 긴급도·카테고리 분류 → 결과를 구글 스프레드시트에 자동 저장 + 긴급 이메일은 텔레그램으로 즉시 알림.
시나리오 2: 회의록 자동 노션 정리
텔레그램에서 회의 내용 입력 → OpenClaw가 요약·액션 아이템 추출 → trigger-n8n 스킬로 n8n 웹훅 호출 → n8n Notion 노드가 자동으로 새 페이지 생성·내용 저장.
시나리오 3: 슬랙 메시지 AI 자동 응답
슬랙 특정 채널에 메시지 수신(n8n Slack 트리거) → OpenClaw로 내용 전달 및 답변 생성 요청 → AI 답변을 다시 슬랙 채널에 자동 포스팅.
📎 공식 문서 Protocols and APIs 섹션 보기 →
실전 팁과 주의사항
- localhost 통신으로 보안 최대화: n8n과 OpenClaw를 같은 서버에서 운영하면 모든 통신이
localhost를 통해 이루어져 외부 해킹 위험이 없습니다. 분리된 서버에 있다면 반드시 VPN 터널이나 Bearer 토큰 인증을 적용하세요. - n8n 워크플로우 Error Handling 필수: n8n 워크플로우에 반드시 Error Trigger 노드를 추가하세요. OpenClaw API 호출이 실패하거나 타임아웃이 발생할 때 슬랙·텔레그램으로 오류 알림을 받도록 설정하면 파이프라인 장애를 즉시 감지할 수 있습니다.
- 토큰 헤더 필수 확인: n8n HTTP Request 노드에서 OpenClaw를 호출할 때
Authorization: Bearer 토큰값헤더를 빠뜨리면 401 인증 오류가 발생합니다. 헤더 설정을 반드시 확인하세요. - SKILL.md 작성의 중요성: 커스텀 툴의
SKILL.md를 구체적이고 명확하게 작성할수록 AI가 적절한 상황에서 정확하게 스킬을 호출합니다. 언제, 어떤 데이터를 어떤 형식으로 전달하는지 상세히 기술하세요.
자주 묻는 질문 (FAQ)
- n8n도 무료로 사용할 수 있나요?
- 네! n8n Community Edition은 무료로 셀프 호스팅이 가능합니다. Docker 한 줄 명령어로 설치하면 Zapier처럼 실행 횟수 제한이나 월 구독료 없이 무제한으로 워크플로우를 구성할 수 있습니다. OpenClaw와 함께 로컬 서버에 구축하면 완전 무료 초자동화 환경이 완성됩니다.
- Zapier나 Make.com 대신 n8n을 추천하는 특별한 이유가 있나요?
- 가장 큰 이유는 데이터 프라이버시와 비용입니다. 회사 기밀이나 개인의 민감한 대화를 자동화할 때, 외부 클라우드인 Zapier를 거치면 정보 유출 우려가 있습니다. 내 서버에서 OpenClaw와 n8n이
localhost로 통신하면 외부 망을 전혀 타지 않아 완벽한 보안을 유지할 수 있습니다. - n8n에서 OpenClaw로 데이터를 보낼 때 해킹의 위험은 없나요?
- 같은 서버 내에서
localhost로 통신한다면 외부 해킹 위험이 없습니다. 분리된 서버에 있다면 n8n의 HTTP Request 노드에 OpenClaw의auth.token을 Bearer 토큰으로 반드시 포함시켜 인증을 거치도록 설정하세요. - 코딩을 전혀 몰라도 openclaw n8n 연동이 가능한가요?
- 충분히 가능합니다! 파이썬 코드를 직접 짤 필요 없이, n8n의 시각적인 노드 연결 화면(Drag & Drop)과 OpenClaw의 기본
web_fetch도구를 조합하는 것만으로도 훌륭한 자동화 파이프라인을 만들 수 있습니다. 이 글에 제시된 예제 코드를 복사·붙여넣기 하는 것부터 천천히 시작해 보세요.
이 글이 도움이 됐다면 댓글로 여러분의 경험을 알려주세요! 🙌
openclaw n8n 연동에서 막히는 부분은 댓글에 남겨주세요 — 직접 답변드립니다.
📬 새 편 알림 받기 → AI 활용 가이드 구독
댓글