안녕하세요
이번 시간에는 오픈클로(OpenClaw, 구 Clawbot)에 노션(Notion)을 연동해서 글을 쓰는 방법에 대해 공유 드리겠습니다.
OpenClaw가 무엇이고 설치방법 등이 궁금하시다면 아래 글을 하나씩 읽어보시길 추천 드립니다.
＊ 오픈클로 관련 글
- 2026.01.28 - [IT/AI] - "자비스가 현실로?" 알아서 일하는 AI 오픈클로(OpenClaw. 구 클로드봇)의 정체와 핵심 기능
- 2026.01.28 - [IT/AI] - 0원으로 나만의 AI 비서 만들기: 오픈클로(OpenClaw, 구 클로드봇) 비용 및 무료 사용법 총정리
- 2026.01.30 - [IT/AI] - [실전 가이드] 오픈클로(OpenClaw) 설치부터 제미나이(Gemini) 무료 연동까지 완벽 가이드(feat. 구 클로드봇(Clawdbot) 설치 가이드)
- 2026.01.31 - [IT/AI] - [실전 가이드] 오픈클로(OpenClaw. 구 Clawdbot)에 텔레그램(Telegram) 채널 등록 완벽 가이드
- 2026.02.01 - [IT/AI] - [실전 가이드] 오픈클로(OpenClaw. 구 Clawdbot)으로 인터넷 검색하기(feat. Brave Search API 연동)
[목차여기]
1. 사전 준비사항(prerequisite)
2. Clawhub(Skill 저장소) Manager(관리도구) 설치
우선 노션(Notion) 연동하는 스킬(skill)은 OpenClaw 기본 내장 스킬에는 포함되어 있지 않습니다(설치 시 셋팅하는 skills). 그렇기 때문에 필요한 스킬은 Clawhub(오픈클로 스킬 저장소) 에서 다운 받으셔야 합니다.
① Clawhub 홈페이지로 이동
Clawhub의 홈페이지(https://www.clawhub.ai/)로 이동하여 회원가입(github 계정 연동)을 해줍니다.
이곳에서 OpenClaw 에이전트가 사용할 수 있는 스킬들을 검색할 수 있으니 추후에도 필요하신 스킬이 있으시면 검색하셔서 다운 받으시면 됩니다.
② Notion 검색
Clawhub에서 노션(Notion) 스킬(Skill)을 검색해봅니다.
Browse skills -> 검색어 창에 Skill 명을 입력하여 검색합니다. 저는 첫번째 세번째 스킬인 notion-skill이 맘에 드네요. 이걸 설치해 봐야 겠습니다.
③ 커맨드 창에서 Clawhub Manager 설치
Clawhub에서 검색한 스킬을 설치하기 위해서는 아래 내 로컬 PC에 Clawhub Manager 설치가 필요합니다.
가이드(https://docs.openclaw.ai/tools/clawhub) 에 나온 명령어로 진행하시면 됩니다.
명령어 :
npm i -g clawhub
④ 커맨드 창에서 노션 스킬 설치
다음으로 설치한 Clawhub Manager를 이용하여 노션(Notion)을 검색해 보겠습니다. 아까 Clawhub 홈페이지에서 봤던 notion-skill 이 보입니다.
명령어 :
clawhub search notion
검색된 notion-skill을 설치 후 최신 버전으로 업데이트 해보겠습니다.
설치 및 업데이트 명령어 :
clawhub install notion-skill
clawhub update --all
⑤ 설치된 스킬 확인
설치된 스킬은 아래 명령어를 통해 확인 가능합니다.
clawhub list
또한 설치가 완료되면 .openclaw/workspace/skills 디렉토리 하위에 notion-skill 디렉토리 및 파일이 생성되며, SKILL.md 파일에도 노션 관련 내용이 추가됩니다.
3. 노션 API key 발급 및 오픈클로에 등록
이제 오픈클로가 사용하는 노션 스킬 설치가 완료되었습니다.
이제 필요한 게 뭔지 Clawhub에서 notion-skill 스킬의 문서를 다시 보겠습니다(https://www.clawhub.ai/Dimagious/notion-skill)
문서를 보시면 노션 API 를 사용하기 위한 노션 API Key 발급 및 오픈클로에 등록해야 합니다.
① Notion Integration 에서 노션 API Key 발급
우선 https://www.notion.so/profile/integrations 로 이동하셔서 "Create a new integration" 을 선택합니다.
제목을 입력하고, Associated workspace에 오픈클로와 연동할 워크스페이스를 입력 후 생성합니다.
그리고 생성된 노션 API Key(ntn_XXXXXXXXXXXXXX)를 복사해 줍니다.
② 노션 페이지 접근 권한 생성
다음으로 생성한 노션 API가 노션 페이지에 접근할 수 있도록 연동시켜 주겠습니다.
노션 API Key를 통해서 오픈클로가 게시글을 작성할 노션 페이지로 이동합니다.
노션 페이지 좌측 사이드바 -> Settings -> Connections -> "..." -> Manage page access 을 선택합니다.
접근할 페이지를 선택하고 Save를 눌러줍니다.
③ openclaw.json 파일 수정
다음으로 openclaw.json 파일에 발급받은 API Key를 등록하면 됩니다.
등록하기 전에 조금 전 열었던 SKILL.md 파일에 있던 환경변수 명을 보면 키 명칭이 NOTION_API_KEY인 것을 확인할 수 있습니다.
이제 .openclaw/openclaw.json 파일을 열어 skills 항목에 아래 내용을 추가해 줍니다(entries 하위 내용 및 NOTION_API_KEY 추가)
"skills": {
...
"entries": {
"notion-skill": {
"enabled": true,
"env": {
"NOTION_API_KEY": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
},
④ 오픈클로(OpenClaw) 재시작
추가가 완료되셨으면 오픈클로 재시작을 해주시면 됩니다.
openclaw gateway restart
※ (참고) 이 부분에서 잘 안되시는 분들이 있으실 텐데요. 재시작이 잘 안되실 경우는 오픈클로가 점유하고 있는 PID를 강제로 죽이시고 재시작하시기 바랍니다.
혹은 재시작해도 openclaw가 본인의 설정을 못읽는 경우가 있는데요. 이럴 때는 디렉토리를 가르쳐주고 다시 읽으라고 하면 정상적으로 반영됩니다.
⑤ 노션 페이지에 글쓰기
이제 notion-cli 도 설치가 끝났으니 오픈클로(OpenClaw) 한테 노션 페이지에 글을 써보라고 명령해 보겠습니다.
분명 성공은 했는데요. "테스트"라는 글씨가 아니라 물음표로 글씨가 작성되었습니다.
4. 노션(Notion) 인코딩 설정 변경
① 인코딩 변경 후 글 작성
오픈클로(OpenClaw)가 Powershell(Windows 기준) 명령어를 통해서 노션(Notion)에 글을 쓰는데요. 이때 Poswershell 인코딩 설정이 한글 작성할 수 없는 설정이기 때문에 한글이 깨지게 됩니다.
제가 여러 설정을 해 보았지만, 결국 윈도우 환경에서는 Powershell에 적용된 인코딩 설정이 제일 우선시 되기 때문에 Powershell 인코딩 설정을 바꿔주면 된다고 합니다만..
저희는 오픈클로를 쓰고 있으니... 오픈클로한테 요청해 보겠습니다.
② 노션 인코딩 기본 설정 적용(UTF-8)
정상적으로 한글이 써집니다.
하지만 앞으로 노션에 글을 쓰는 것을 요청할 때마다 인코딩을 말하긴 귀찮으니...
앞으로는 노션에 등록 시에는 인코딩을 "UTF-8"로 맞춰달라고 이야기 해보겠습니다.
오픈클로가 말한 것처럼 .openclaw/TOOLS.md 파일에 인코딩 규칙이 추가된 것을 확인할 수 있습니다(사실 한번데 추가된 건 아니고, 이상한 곳에 추가하길래 다시 추가하라고 하니 정상적으로 추가했습니다. 아직은 100% 믿진 못하겠습니다)
다시 테스트를 해보면 정상적으로 한글이 써지는 것을 확인할 수 있습니다.
명령 : "잡담"페이지 하위에 "잡담1" 페이지 만들고 "열심히하겠습니다" 라고 써줘"
5. 마치며
이번 글에서는 오픈클로(OpenClaw)을 활용하여 노션에 글을 작성하는 방법에 대해 공유 드렸습니다.
한번 더 정리하면 아래와 같습니다.
- Clawhub Manager 설치 및 노션 Skill 다운로드
- 노션(Notion) API Key를 발급 맟 페이지 접근 권한 설정
- 오픈클로(OpenClaw)에 노션 API Key 등록 후 재기동
- 노션 글 작성 시 인코딩 설정
- 노션에 글 작성
오픈클로 봇 설정 시, 잘 적용되지 않는 건 오픈클로한테 직접 요청해도 적용이 되는게 참 좋은 거 같습니다(물론 100% 정확하게 설정하진 않아서 모니터링은 필요해 보입니다)
오늘 작성한 글이 도움이 되시길 바랍니다.
화이팅하세요!!
댓글