openclaw 연동 가이드

글쓴이 /

개요

  • OpenClaw는 단순히 질문에 답하는 챗봇이라기보다, 여러 입력 채널과 도구, 문서 시스템, 실행 환경을 연결해 실제 작업 흐름을 이어주는 에이전트 실행 계층에 가깝다.
  • 메시지 채널에서 요청을 받고, 필요한 문맥과 메모리를 읽고, 외부 도구를 호출하고, 작업 결과를 다시 문서나 다른 시스템에 반영하는 식으로 동작한다.
  • 즉, “대답을 잘하는 모델” 자체보다, 그 모델을 실제 운영 환경 안에서 일하게 만드는 연결 구조에 더 가깝다고 보는 편이 맞다.

연동가이드

  • Openclaw 설치
  • OpenRouter API 사용
  • Obsidian 연동
  • Slack / Telegram 연동

이 글의 핵심 포인트

  1. OpenClaw 전체 구조도
  2. LLM API key 연결 방식
  3. Slack / Telegram 연동 방식
  4. Obsidian을 문서화/기억 계층으로 사용

준비

  • openrouter
    • openrouter 에서 api 결제하여 사용
    • 혹은 chatgpt oauth 사용

구조도 1: 전체 아키텍처

flowchart TD
    U[사용자 입력]
    U --> MM[Mattermost / Slack / Telegram / Discord]
    MM --> OC[OpenClaw]
    OC --> OR[OpenRouter / LLM API]
    OC --> OB[Obsidian]
    OC --> MEM[Memory files]
    OC --> EXT[외부 도구 / 서버 / 블로그]
    OR --> M1[모델 라우팅]
    OB --> DOCS[운영 문서 / 초안 / 발행용 문서]
    MEM --> DAILY[daily memory]
    MEM --> LONG[long-term memory]
  • OpenClaw는 실행 계층 역할을 한다.
  • 입력 채널은 Mattermost, Slack, Telegram처럼 여러 개가 될 수 있고, 모델 호출은 OpenRouter를 통해 묶는다.
  • 문서화는 Obsidian으로 흐르게 하고, 메모리는 별도 memory 파일로 유지한다.

openclaw 설치

스크린샷 2026-03-30 오후 8.38.15

curl -fsSL https://openclaw.ai/install.sh | bash

openclaw 세팅

openclaw onboard
  • onboard 를 통해 setup 을 진행한다

스크린샷 2026-03-30 오후 9.08.39

  • Setup mode > Manual
    • Local gateway (this machine)
  • workspace 기본값
    • ~/.openclaw/workspace
  • Model/auth provider
    • openrouter + API key
    • openai + oauth
  • Gateway port: 18789
  • LAN(0.0.0.0): 같은 네트워크 상에 접근을 위해 LAN 으로 세팅
  • Gateway auth: Token
  • Tailscale exposure: Off (외부에서 접근은 vpn 으로 접근)
  • Generate/store plaintext token (default)

chat channel

  • 외부에서 openclaw에게 명령들을 내리기 위한 도구
  • 본 가이드에서는 slack / discord / telegram 사용 예정
  • 각 채널별로 협업을 위한 역할을 나눔
    • slack: 업무 / 협업
    • telegram: 개인 메시지 전달
위로 스크롤