Go back

OpenClaw와 Notion 연동: AI로 노트와 데이터베이스 관리하기

Published:  at  09:20 PM

OpenClaw을 텔레그램이나 Slack에 연동했다면, 이제 Notion과도 연결해보세요. AI에게 “오늘 회의록 정리해줘”라고 말하면 Notion 페이지가 생성되고, “이번 주 마감 작업 목록 보여줘”라고 하면 데이터베이스에서 필터링된 결과를 받을 수 있습니다.

이 글에서는 OpenClaw에 Notion Skill을 설치하고 설정하는 방법을 단계별로 안내합니다. Notion Integration 생성부터 페이지 접근 권한 설정, 실전 활용 예제까지 포함합니다.

OpenClaw 설치가 아직 안 되어 있다면 맥에서 OpenClaw 설치 및 설정 가이드를 먼저 참고하세요. 텔레그램 연동이 필요하다면 OpenClaw와 텔레그램 연동 가이드도 함께 보세요.

왜 Notion인가?

OpenClaw은 Notion을 Skill로 지원합니다. 채널(텔레그램, Slack 등)과는 다른 개념입니다.

Notion Skill을 설치하면, 어떤 채널(텔레그램, Slack, Discord 등)을 사용하든 자연어로 Notion을 제어할 수 있습니다.

주요 기능

사전 준비

시작하기 전에 필요한 것:

항목설명
OpenClaw설치 및 AI 모델 설정 완료
Notion 계정워크스페이스가 있는 Notion 계정
연동할 페이지/DBAI가 접근할 Notion 페이지 또는 데이터베이스
10분Integration 생성 + Skill 설정 소요 시간

Step 1: Notion Integration 생성

Notion API를 사용하려면 Internal Integration을 생성해야 합니다.

Integration 생성하기

  1. Notion Integrations 페이지 ↗로 이동합니다.
  2. ”+ New integration” 버튼을 클릭합니다.
  3. Integration 정보를 입력합니다:
    • Name: “OpenClaw AI” (원하는 이름 가능)
    • Logo: 선택사항 (OpenClaw 로고 이미지 URL)
    • Associated workspace: 사용할 워크스페이스 선택
  4. Capabilities에서 필요한 권한을 활성화합니다:
    • ✅ Read content (필수)
    • ✅ Update content (필수, 페이지/DB 수정용)
    • ✅ Insert content (필수, 새 페이지 생성용)
  5. Submit을 클릭합니다.

Integration Token 복사

Integration이 생성되면 **“Internal Integration Token”**이 표시됩니다. 형식은 다음과 같습니다:

secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

보안 주의: 이 토큰은 비밀번호와 같습니다. 절대 Git에 커밋하지 마세요. .env 파일이나 비밀번호 관리자에 보관하는 것을 권장합니다.

Step 2: Notion Skill 설치

OpenClaw에 Notion Skill을 설치합니다.

Skill 설치

openclaw skill install notion

Docker 환경이라면:

docker compose run --rm openclaw-cli skill install notion

Skill 활성화

openclaw skill enable notion

설정 파일 확인

설치 후 ~/.openclaw/config/skills/notion.yaml 파일이 생성됩니다. 내용을 확인합니다:

notion:
  enabled: true
  api_token: "" # 여기에 토큰을 입력해야 함
  api_version: "2022-06-28"

Step 3: API Token 설정

Notion Integration Token을 OpenClaw 설정에 추가합니다.

방법 1: 환경 변수 사용 (권장)

.env 파일 또는 환경 변수로 설정:

export NOTION_API_KEY="secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

또는 ~/.openclaw/.env 파일에 추가:

NOTION_API_KEY=secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

설정 파일에서 환경 변수 참조:

notion:
  enabled: true
  api_token: "${NOTION_API_KEY}"
  api_version: "2022-06-28"

방법 2: 설정 파일에 직접 입력

보안상 권장하지 않지만, 테스트 목적으로 직접 입력할 수도 있습니다:

notion:
  enabled: true
  api_token: "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  api_version: "2022-06-28"

주의: 설정 파일에 토큰을 직접 입력했다면, Git에 커밋하지 않도록 .gitignore에 ~/.openclaw/config/를 추가하세요.

Step 4: 페이지 접근 권한 부여

중요: Notion Internal Integration은 기본적으로 어떤 페이지에도 접근할 수 없습니다. 각 페이지/데이터베이스를 명시적으로 공유해야 합니다.

페이지 공유하기

  1. Notion에서 AI가 접근할 페이지를 엽니다.
  2. 우측 상단의 ”…” 메뉴를 클릭합니다.
  3. “Add connections” 또는 **“연결 추가”**를 선택합니다.
  4. 생성한 Integration (예: “OpenClaw AI”)을 선택합니다.

데이터베이스 공유하기

데이터베이스도 동일한 방식으로 공유합니다:

  1. 데이터베이스 페이지를 엽니다.
  2. 우측 상단 ”…” → “Add connections”
  3. Integration 선택

워크스페이스 전체 공유 (선택사항)

모든 페이지에 접근하려면 각 페이지를 개별적으로 공유해야 합니다. Notion은 워크스페이스 레벨의 일괄 공유 기능을 제공하지 않습니다.

Step 5: Skill 테스트

설정이 완료되었으면 Skill이 정상 작동하는지 테스트합니다.

페이지 목록 조회

openclaw skill test notion --action list_pages

성공하면 접근 가능한 페이지 목록이 출력됩니다.

채팅으로 테스트

텔레그램이나 다른 채널이 연결되어 있다면, 자연어로 테스트할 수 있습니다:

"Notion에서 오늘 날짜로 새 페이지 만들어줘"
"내 Notion 워크스페이스에서 '프로젝트' 검색해줘"

실전 활용 예제

예제 1: 회의록 자동 생성

텔레그램에서:

"오늘 회의록 작성해줘. 제목은 '2026-02-16 스프린트 계획 회의', 내용은 '주요 안건: 1) 기능 A 개발 2) 버그 B 수정 3) 다음 주 배포 계획'"

AI가 Notion에 페이지를 생성합니다.

예제 2: 데이터베이스 쿼리

작업 관리 데이터베이스가 있다면:

"이번 주 마감 작업 중 우선순위가 높은 것만 보여줘"
"프로젝트 '블로그 리뉴얼'의 진행 중인 작업 목록 보여줘"

AI가 데이터베이스를 쿼리하여 필터링된 결과를 반환합니다.

예제 3: 작업 상태 업데이트

"작업 'OG 이미지 생성 기능' 완료 처리해줘"
"데이터베이스에서 '버그 수정' 항목의 우선순위를 높음으로 변경해줘"

예제 4: 검색

"Notion에서 '배포' 관련 페이지 찾아줘"
"최근에 수정한 문서 중 '가이드' 제목인 것 보여줘"

고급 설정

Rate Limit 관리

Notion API는 초당 3개 요청으로 제한됩니다. OpenClaw은 자동으로 Rate Limit을 관리하지만, 대량 작업 시 주의가 필요합니다.

데이터베이스 스키마 이해

Notion 데이터베이스는 복잡한 구조를 가집니다. AI가 정확하게 쿼리하려면:

예시:

"작업 데이터베이스(데이터베이스 URL)에서 상태가 '진행 중'이고 담당자가 '푸땡'인 항목만 보여줘"

웹훅 연동 (향후 기능)

현재 Notion API는 실시간 웹훅을 지원하지 않습니다. Notion 변경사항을 OpenClaw에 알리려면:

문제 해결

”Page not found” 오류

원인: Integration에 페이지 접근 권한이 없음

해결:

  1. Notion에서 해당 페이지를 엽니다
  2. ”…” → “Add connections” → Integration 선택
  3. OpenClaw을 재시작합니다

”Invalid API token” 오류

원인: 토큰이 잘못되었거나 만료됨

해결:

  1. Notion Integrations 페이지 ↗에서 토큰 확인
  2. notion.yaml 파일의 api_token 값 재확인
  3. 환경 변수 NOTION_API_KEY가 올바르게 설정되었는지 확인

”Rate limit exceeded” 오류

원인: 초당 3개 요청 제한 초과

해결:

Skill이 인식되지 않음

원인: Skill이 제대로 설치/활성화되지 않음

해결:

# Skill 목록 확인
openclaw skill list

# 재설치
openclaw skill uninstall notion
openclaw skill install notion
openclaw skill enable notion

# OpenClaw 재시작

보안 고려사항

토큰 관리

접근 권한 최소화

Integration 토큰 재발급

토큰이 유출되었다면:

  1. Notion Integrations 페이지 ↗로 이동
  2. 해당 Integration의 ”…” 메뉴 클릭
  3. “Delete” 또는 “토큰 재발급” 선택
  4. 새 토큰으로 OpenClaw 설정 업데이트

마무리

이 글에서 다룬 내용을 정리합니다.

  1. Notion Integration 생성 — Internal Integration으로 API 토큰 발급
  2. Notion Skill 설치 — openclaw skill install notion
  3. API Token 설정 — 환경 변수 또는 설정 파일에 토큰 추가
  4. 페이지 접근 권한 부여 — 각 페이지/데이터베이스를 Integration에 공유
  5. 실전 활용 — 자연어로 페이지 생성, 데이터베이스 쿼리, 작업 자동화

Notion Skill을 활용하면 AI가 단순한 대화를 넘어 실제 작업 도구로 활용됩니다. 회의록 작성, 작업 관리, 문서 검색까지 자연어 한 마디로 처리할 수 있습니다.

참고 자료

공식 문서

관련 포스트

참고 가이드

Share this post on:
Share this post via WhatsApp Share this post on Facebook Share this post on X Share this post via Telegram Share this post on Pinterest Share this post via email
Previous Post
OpenClaw와 텔레그램 연동: 봇 생성부터 그룹 활용까지