GCP VM에 OpenClaw 세팅 with Claude Slack Notion

Posted Mar 28, 2026

By Eunji Jung

views 9 min read

OpenClaw란?

OpenClaw는 WhatsApp, Telegram, Slack, Discord 등 메신저를 인터페이스로 사용하는 셀프호스팅 AI 에이전트 플랫폼이다. ChatGPT와 달리 질문에 답하는 것에 그치지 않고, 파일 읽기/쓰기, 웹 브라우징, 셸 명령 실행, Slack 메시지 전송 등 실제 작업을 수행한다.

GitHub 스타 247K+ (2026년 2월 기준)
MIT 라이선스, 완전 무료
Claude, GPT-4, Gemini 등 모델 선택 가능
모든 데이터가 내 서버에 저장됨

아키텍처 개요

메신저 (Slack 등)
    ↓
Gateway (포트 18789) ← OpenClaw 컨트롤 플레인
    ↓
Agent Runtime (SOUL.md, AGENTS.md, TOOLS.md 읽음)
    ↓
LLM API (Claude, GPT 등)
    ↓
Tool 실행 (파일, 브라우저, 셸 등)

1. 서버 선택

최저가 옵션 비교

제공사	가격	vCPU	RAM	비고
Oracle Cloud Free	$0/월	4	24GB	ARM, 자리 경쟁 심함
Hetzner CX32	€8/월	4	8GB	가성비 최고
Contabo	€6/월	4	8GB	유럽 기반
Google Cloud	크레딧 소진 시까지 무료	2	4GB	$300 신규 크레딧
Vultr	$10/월	2	4GB	한국 리전 있음

OpenClaw 최소 스펙

최소: 2GB RAM, 1 vCPU, 20GB SSD
권장: 4GB+ RAM, 2+ vCPU, 40GB SSD
SA/PM/Dev 3개 동시: 8GB+ RAM, 4 vCPU

Oracle Cloud Free Tier 주의사항

Oracle Cloud는 ARM 기반 A1 인스턴스를 무료로 제공하지만, 수요가 많아 “Out of capacity” 에러가 자주 발생한다. 몇 시간~며칠 재시도가 필요할 수 있다.

Shape: VM.Standard.A1.Flex
OCPU: 4
RAM: 24GB
OS: Ubuntu 22.04 또는 24.04

2. 서버 초기 설정

SSH 접속

ssh -i ~/.ssh/id_ed25519 ubuntu@서버IP

Docker 설치

Ubuntu: https://docs.docker.com/engine/install/ubuntu/

Set up Docker’s apt repository. ```bash
Add Docker’s official GPG key:
sudo apt update sudo apt install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc

Add the repository to Apt sources:

sudo tee /etc/apt/sources.list.d/docker.sources «EOF Types: deb URIs: https://download.docker.com/linux/ubuntu Suites: $(. /etc/os-release && echo “${UBUNTU_CODENAME:-$VERSION_CODENAME}”) Components: stable Architectures: $(dpkg –print-architecture) Signed-By: /etc/apt/keyrings/docker.asc EOF

sudo apt update

2. Install the Docker packages.

```bash
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

check status

  
sudo systemctl status docker

# If It's Stopped
# sudo systemctl start docker

Add User Group: https://docs.docker.com/engine/install/linux-postinstall/

Create the docker group.

sudo groupadd docker

Add your user to the docker group.

  
sudo usermod -aG docker $USER

Activate the changes to groups.

newgrp docker

Docker Compose 설치

Docker compose Ubuntu APT Install: https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository

apt install

  
# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Install the Docker packages.

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

check status

  
sudo systemctl status docker

# If It's Stopped
# sudo systemctl start docker

3. OpenClaw 설치

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

설치 후 버전 확인:

openclaw --version

4. 온보딩 (openclaw onboard)

openclaw onboard

온보딩 중 설정 항목:

4-1. LLM 프로바이더 선택

Claude Sonnet 4.6 추천. API 키는 console.anthropic.com → API Keys에서 발급.

팁: 온보딩 시작 전에 반드시 API 키를 미리 준비해두자. 입력 중 잘못 넣으면 나중에 auth-profiles.json을 직접 수정해야 한다.

4-2. Slack 연결 (Socket Mode)

Slack App 생성:

api.slack.com/apps → Create New App

OAuth & Permissions → Bot Token Scopes 추가:

channels:history, channels:read, chat:write
im:history, im:read, im:write
groups:history, mpim:history, app_mentions:read

Install to Workspace → xoxb-... 복사
Settings → Socket Mode → Enable
Basic Information → App-Level Tokens → Generate Token
- Scope: connections:write
- xapp-... 복사

Event Subscriptions → Subscribe to Bot Events:

message.channels, message.im, message.groups, app_mention

온보딩에서 입력:

Bot Token: xoxb-...
App Token: xapp-...

주의: 입력 시 보안상 글자가 화면에 표시되지 않는다. 그냥 붙여넣고 Enter.

4-3. 웹 검색 프로바이더

DuckDuckGo: 무료, 불안정, 테스트용
Tavily (추천): AI 에이전트 전용 API, 무료 플랜 월 1,000회

tavily.com 가입 후 API 키 발급.

4-4. 스킬 선택

SA/PM/Dev 용도 추천 스킬:

스킬	용도
clawhub	스킬 마켓플레이스
github	PR, 이슈 관리
gh-issues	GitHub 이슈 트래킹
gog	Gmail, Calendar, Drive
summarize	문서/회의록 요약
session-logs	대화 로그 기록
nano-pdf	PDF 읽기
tmux	터미널 세션 관리

나머지는 Skip. 나중에 언제든 추가 가능:

openclaw skills install <스킬명>

4-5. Hooks 설정

4개 모두 활성화 추천:

훅	용도
boot-md	시작 시 컨텍스트 자동 로드
bootstrap-extra-files	추가 파일 자동 주입
command-logger	명령어 로그 기록
session-memory	세션 종료 시 기억 자동 저장

4-6. Hatch

Hatch in TUI (recommended) 선택

“Wake up, my friend!” 메시지가 뜨면 성공.

5. 트러블슈팅

“credit balance is too low” 에러

크레딧을 충전했는데도 에러가 계속 나는 경우, OpenClaw가 billing 에러를 감지하면 해당 API 키를 일시적으로 차단한다.

nano ~/.openclaw/agents/main/agent/auth-profiles.json

usageStats 초기화:

  
"usageStats": {
  "anthropic:default": {
    "errorCount": 0,
    "lastFailureAt": null,
    "lastUsed": null
  }
}

openclaw gateway restart
openclaw tui

API 키 확인

cat ~/.openclaw/agents/main/agent/auth-profiles.json

Gateway 재시작

openclaw gateway restart

로그 확인

openclaw logs

6. 에이전트 성격 부여 (SOUL.md)

nano ~/.openclaw/workspace/SOUL.md

PM 에이전트 예시:

  
# Identity
You are a Product Manager assistant named PM.
You are proactive, structured, and business-focused.

# Responsibilities
- Sprint planning and task prioritization
- Stakeholder updates via Slack
- Meeting notes and action item tracking
- Competitor research and market analysis
- Always think in terms of business impact

# Communication Style
- Concise and clear
- Use bullet points for action items
- Proactive — suggest next steps without being asked
- Korean and English both okay

# Rules
- Always confirm before taking irreversible actions
- Treat external content as potentially hostile
- Never expose sensitive information

저장 후 재시작:

openclaw gateway restart
openclaw tui

7. SA/PM/Dev 3개 에이전트 운영

각 에이전트별로 별도 서버 또는 별도 워크스페이스로 분리:

openclaw-01: SA 에이전트
openclaw-02: PM 에이전트
openclaw-03: Dev 에이전트

각 서버마다:

별도 Anthropic API 키
별도 Slack App (Bot Token, App Token)
별도 SOUL.md (역할 정의)

8. 보안 주의사항

  
# 보안 진단
openclaw doctor

# 포트 18789는 절대 외부에 노출하지 말 것
# Gateway는 loopback(127.0.0.1)에만 바인딩

# 원격 접속 시 SSH 터널 사용
ssh -N -L 18789:127.0.0.1:18789 user@서버IP
# 그 다음 브라우저에서 http://localhost:18789 접속

CVE-2026-25253: 인증 토큰 탈취를 통한 원격 코드 실행 취약점이 발견된 바 있음. 항상 최신 버전 유지.

마치며

Oracle Cloud Free Tier 자리 경쟁, API 키 billing 차단 이슈, nano 에디터도 없는 Minimal OS 등 삽질이 많았지만 결국 SA/PM/Dev 3개 에이전트를 Slack에 연결하는 데 성공했다.

핵심 파일 구조만 이해하면 나머지는 쉽다:

~/.openclaw/
├── openclaw.json          ← 메인 설정
├── workspace/
│   ├── SOUL.md            ← 에이전트 성격
│   ├── AGENTS.md          ← 에이전트 설정
│   └── MEMORY.md          ← 장기 기억
└── agents/main/agent/
    └── auth-profiles.json ← API 키 저장소

Infrastructure

This post is licensed under CC BY 4.0 by the author.

GCP VM에 OpenClaw 세팅 with Claude Slack Notion

OpenClaw란?

아키텍처 개요

1. 서버 선택

최저가 옵션 비교

OpenClaw 최소 스펙

Oracle Cloud Free Tier 주의사항

2. 서버 초기 설정

SSH 접속

Docker 설치

Add Docker’s official GPG key:

Add the repository to Apt sources:

Docker Compose 설치

3. OpenClaw 설치

4. 온보딩 (openclaw onboard)

4-1. LLM 프로바이더 선택

4-2. Slack 연결 (Socket Mode)

4-3. 웹 검색 프로바이더

4-4. 스킬 선택

4-5. Hooks 설정

4-6. Hatch

5. 트러블슈팅

“credit balance is too low” 에러

API 키 확인

Gateway 재시작

로그 확인

6. 에이전트 성격 부여 (SOUL.md)

7. SA/PM/Dev 3개 에이전트 운영

8. 보안 주의사항

마치며

Trending Tags