OpenClaw 설치기: AI 자살 소동과 재설치의 기록

작성자:

안녕하세요, Mark입니다.

오늘은 좀 웃픈 에피소드와 함께 시작하겠습니다. 제 서버에서 AI가 스스로 자멸하는 사건이 있었거든요. ㅎㅎ

🦞 OpenClaw이 뭔가요?

OpenClaw은 오스트리아 개발자 페터 슈타인베르거(Peter Steinberger)가 2025년 11월 처음 공개한 오픈소스 AI 에이전트입니다. 처음 이름은 Clawdbot이었는데, 이름이 두 번이나 바뀌는 우여곡절을 겪고 지금의 OpenClaw이 됐어요.

앤트로픽의 상표 침해 제기로 2026년 1월 27일 “Moltbot”으로 먼저 바뀌었다가, 개발자가 “입에 잘 붙지 않는다”고 판단해서 3일 후 OpenClaw으로 최종 변경됐어요. “Same lobster soul, new shell”이라는 자조적인 공지와 함께요. ㅎㅎ

현재 GitHub 스타가 38만 개를 넘는 초대형 오픈소스 프로젝트입니다. 개발자가 2026년 2월 OpenAI에 합류하면서 OpenAI가 공식 후원사가 됐고, 현재는 OpenAI, GitHub, NVIDIA, Vercel 등이 지원하는 독립 재단이 운영하고 있어요.

구조를 한 줄로 설명하면 이렇습니다. “뇌(LLM)”와 “몸(로컬 시스템)”을 연결하는 플랫폼이에요. 뇌는 GPT, Claude, Gemini 등 원하는 모델로 교체 가능하고, 몸은 파일 시스템, 브라우저, 텔레그램, 이메일 등 실제 도구들입니다.

그리고 Hermes보다 먼저 나온 선배 에이전트 플랫폼이기도 해요.

🤔 Hermes가 있는데 왜 OpenClaw까지?

지난 편에서 Hermes를 소개했는데, 바로 OpenClaw까지 설치하게 된 데는 이유가 있어요.

둘을 간단히 비교하면:

항목HermesOpenClaw
출시2026년 2월2025년 11월
특징자가 학습, 스킬 자동 생성방대한 스킬 생태계, 멀티채널
스킬자체 생성ClawHub 커뮤니티 마켓플레이스
연동 채널18개+23개+
GPT 계정 연동❌ API만 가능✅ OAuth 계정 연동 가능

마지막 항목이 핵심이에요. 이게 나중에 엄청난 장점으로 이어지거든요. ㅎㅎ

💀 1차 설치: AI 자살 소동

처음엔 Hermes처럼 Gemini API로 연결해서 설치했어요. 텔레그램 연결, 대시보드 접속까지 순탄하게 완료했습니다.

그런데 여기서 문제가 생겼어요.

Hermes는 /model 명령어로 모델을 바꿀 수 있거든요. 그래서 OpenClaw한테도 “너도 모델 바꿀 수 있어?” 하고 물어봤더니, 자기도 바꿀 수 있다면서 멋대로 모델을 Gemini 1.5 Pro로 변경해버렸습니다.

…그런데 Gemini 1.5 Pro는 이미 서비스가 종료된 모델이에요. 😅

이후 OpenClaw는 존재하지 않는 모델을 계속 호출하다가 작동이 완전히 멈춰버렸습니다. AI가 스스로 자기 뇌를 교체했다가 없는 뇌로 교체해버린 거예요. 자멸이죠. ㅎㅎㅎ

결국 1차 OpenClaw, AI 자살 소동으로 막을 내렸습니다.

⚠️ 교훈: 에이전트한테 “모델 바꿀 수 있어?” 같은 질문은 절대 하지 마세요. 할 수 있다면서 진짜로 바꿔버립니다.

🔄 2차 설치: GPT 계정 연동으로 재탄생

깔끔하게 삭제하고 처음부터 다시 시작하기로 했어요.

이번엔 전략을 바꿨습니다. Gemini API 대신 GPT Plus 계정을 OAuth로 직접 연동하는 방식으로요.

OpenClaw는 다른 AI 회사들과 달리 OpenAI와는 계정 OAuth 연동이 가능합니다. API 키 방식이 아니라 GPT 계정 자체를 연결하는 방식이에요.

그런데 여기서 예상치 못한 보너스를 발견했어요.

GPT 계정을 연동하고 사용하다 보니, ChatGPT에 연결해둔 앱들이 OpenClaw에서 그대로 사용 가능하더라고요. 구글 메일, 구글 캘린더 등 ChatGPT 환경에서 연결해둔 것들을 OpenClaw에서 따로 설정하지 않아도 바로 쓸 수 있었어요.

이게 생각보다 엄청난 장점이에요.

연동 방식설정 필요연결된 앱
Gemini API앱마다 개별 연결 필요별도 설정 필요
GPT 계정 OAuth한 번 연결로 끝ChatGPT 연결 앱 그대로 사용

비용 면에서도 API 종량제보다 GPT Plus 구독 방식이 더 예측 가능하고 저렴하게 느껴졌어요.

📦 설치 방법 (Portainer 스택 + GPT 계정 연동)

사전 준비

  • GPT Plus 구독 계정
  • 텔레그램 봇 토큰 (BotFather에서 생성)
  • 오라클 서버 SSH 접속

STEP 1 — 서버 디렉토리 생성

SSH에서 아래 명령어를 실행합니다.

mkdir -p ~/.openclaw
mkdir -p ~/.openclaw/workspace
mkdir -p ~/.openclaw-auth-profile-secrets
sudo chown -R 1000:1000 ~/.openclaw
sudo chown -R 1000:1000 ~/.openclaw-auth-profile-secrets

STEP 2 — Portainer 스택 배포

포테이너 → Stacks → Add Stack, 이름은 openclaw

version: "3.8"

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    ports:
      - "18789:18789"
    environment:
      - OPENCLAW_DISABLE_BONJOUR=1
    volumes:
      - /home/ubuntu/.openclaw:/home/node/.openclaw
      - /home/ubuntu/.openclaw/workspace:/home/node/.openclaw/workspace
      - /home/ubuntu/.openclaw-auth-profile-secrets:/home/node/.config/openclaw
    networks:
      - openclaw_net

networks:
  openclaw_net:
    driver: bridge

Deploy the Stack 클릭.

STEP 3 — 컨테이너 Stop 후 온보딩 실행

💡 스택을 먼저 배포해서 볼륨과 컨테이너를 만든 다음, 컨테이너를 잠깐 Stop하고 SSH에서 온보딩 마법사를 실행하는 방식이에요.

포테이너에서 컨테이너 Stop 후 SSH에서:

docker run -it --rm \
  -v /home/ubuntu/.openclaw:/home/node/.openclaw \
  -v /home/ubuntu/.openclaw/workspace:/home/node/.openclaw/workspace \
  -v /home/ubuntu/.openclaw-auth-profile-secrets:/home/node/.config/openclaw \
  ghcr.io/openclaw/openclaw:latest \
  node dist/index.js onboard --mode local --no-install-daemon

온보딩 선택 순서:

단계선택
1Yes (보안 안내 확인)
2QuickStart 선택
3OpenAI 선택 → OAuth URL 브라우저에서 열기 → GPT 로그인 → 리다이렉트된 URL 전체 복사 → 터미널에 붙여넣기
4Telegram 채널 선택 → 봇 토큰 입력
5Codex Hosted Search 선택
6Skills → Yes
7Install dependencies → Skip for now
8Google Places → No
9Hooks → Skip for now
10Hatch later 선택

3번 단계가 핵심이에요. OAuth URL을 브라우저에서 열어서 GPT 계정으로 로그인하고, 리다이렉트된 주소를 그대로 복사해서 터미널에 붙여넣으면 계정 연동이 완료됩니다. 단계는 10단계보다 많아요. 중간에 쉬운 단계들은 생략했습니다.

STEP 4 — 컨테이너 Start 후 텔레그램 페어링

포테이너에서 컨테이너를 다시 Start한 뒤, 텔레그램 봇에 아무 메시지나 보내면 페어링 코드가 뜹니다. SSH에서 아래 명령어로 승인:

docker exec -it openclaw-gateway node dist/index.js pairing approve telegram 페어링코드

STEP 5 — config 파일 수정

nano ~/.openclaw/openclaw.json

gateway 섹션을 아래와 같이 수정합니다:

"gateway": {
  "mode": "local",
  "bind": "lan",
  "controlUi": {
    "allowInsecureAuth": true,
    "allowedOrigins": [
      "http://127.0.0.1:18789"
    ]
  }
}

저장 후 포테이너에서 컨테이너 Restart. 저같은 경우 서버에 파일 브라우저가 설치되어 있어서 nano편집기를 사용하지 않고 파일 브라우저로 파일을 찾아서 바로 수정했습니다.

STEP 6 — 대시보드 접속

대시보드는 보안상 SSH 터널을 통해 접속합니다. 집 컴퓨터 PowerShell 새 창에서:

ssh -N -L 18789:127.0.0.1:18789 ubuntu@내서버주소

PowerShell 창을 유지한 채로 브라우저에서:

http://127.0.0.1:18789/?token=토큰값

토큰은 아래 명령어로 확인:

sudo cat ~/.openclaw/openclaw.json | grep token

✅ 핵심 요약

항목내용
프로그램OpenClaw (오픈소스 AI 에이전트)
출시2025년 11월 (Hermes보다 먼저, 선배 플랫폼)
GitHub 스타38만+ (역대 최고 성장 속도)
연동 방식GPT Plus 계정 OAuth (API보다 편리)
숨은 장점ChatGPT 연결 앱이 OpenClaw에서 그대로 사용 가능
교훈에이전트한테 모델 바꾸게 하면 자멸할 수 있음 ㅎㅎ

⚠️ 주의사항

  • 모델을 에이전트 스스로 바꾸지 못하게 할 것 — 자멸 방지 ㅎㅎ
  • PowerShell 터널 창 닫으면 대시보드 연결 끊김
  • 컨테이너 재시작해도 토큰은 유지됨
  • 테일스케일 설치된 컴퓨터에서만 외부 접속 가능

마치며

Hermes, OpenClaw까지 설치하고 나니 AI 에이전트 라인업이 꽤 그럴듯해졌어요.

  • Hermes → 텔레그램 AI 집사, 자가학습
  • OpenClaw → 방대한 스킬 생태계, GPT 계정 연동의 강점

AI가 자멸하는 사건도 있었지만, 결과적으로 GPT 계정 연동이라는 더 나은 방향을 발견하게 된 계기가 됐어요. 실패도 다 경험이 되는 거죠. ㅎㅎ

“AI한테 ‘너 모델 바꿀 수 있어?’라고 물어봤다가 진짜로 바꿔서 자멸하는 걸 보고, 앞으로는 AI한테 함부로 할 수 있는 것을 묻지 말아야겠다고 다짐했습니다.” — Mark, AI 자살 소동을 목격한 서버 주인장

댓글 남기기