블로그로 돌아가기
오픈클로 · · 4분

오라클 클라우드(Oracle Cloud Infrastructure) 무료 티어에 OpenClaw 설치하기

OCI 무료 티어(램 1GB) 환경에서 OpenClaw를 설치하고, 텔레그램 봇과 Claude를 연결하는 방법을 정리합니다.

OCI OpenClaw 클라우드 AI Cloud
오라클 클라우드(Oracle Cloud Infrastructure) 무료 티어에 OpenClaw 설치하기

OpenClaw란?

OpenClaw는 Peter Steinberger(PSPDFKit 창립자)가 개발한 오픈 소스 개인 AI 비서 프로젝트입니다. 기존의 웹 버전 ChatGPT나 Claude와 달리, 평소 사용하는 채팅 앱(WhatsApp, Discord, 텔레그램 등)에서 직접 실행됩니다.

이 글에서는 OCI 무료 티어(램 1GB) 환경에서 OpenClaw를 설치하는 과정을 다룹니다.


설치 순서

  1. Node.js 설치
  2. SWAP 16G로 설정
  3. npm 병렬 처리 제한
  4. OpenClaw 설치 스크립트 수행 및 설정

1. Node.js 설치

OpenClaw는 Node.js 22 버전 이상이 필요합니다. v22 또는 최신 v24를 설치합니다.

v22 한 번에 설치하기

# Node.js v22 저장소 등록
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# apt로 node, npm 설치
sudo apt install -y nodejs
sudo apt install -y npm

# node 버전 확인
node -v

v24 설치하기

# node 설치
sudo apt install -y nodejs

# npm 설치
sudo apt install -y npm

# node 버전 관리(n) 설치
npm install -g n

# 노드 최신 버전 설치 후 쉘 재실행
sudo n lts

# 노드 버전 확인
node -v

2. SWAP 영역 지정

OCI 프리티어의 메모리는 1GB로 OpenClaw를 돌리기에 턱없이 부족합니다. SWAP 메모리를 설정해야 합니다.

sudo fallocate -l 16G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

3. npm 병렬 처리 제한

설치 중 Out of Memory가 발생할 수 있으므로 npm의 concurrent 설정을 낮춥니다.

# pnpm 설치
sudo npm install -g pnpm

# 병렬 처리 제한 (메모리 절약)
pnpm config set child-concurrency 1
pnpm config set concurrency 1

# Node 메모리 한도 설정
export NODE_OPTIONS="--max-old-space-size=4096"

4. OpenClaw 설치

OpenClaw 공식 설치 스크립트를 실행합니다.

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

설치가 완료되면 다음과 같은 메시지가 출력됩니다:

🦞 OpenClaw installed successfully (2026.1.30)!

Dashboard URL: http://127.0.0.1:18789/

설치 완료 후 onboard를 실행합니다:

openclaw onboard --install-daemon

OCI 프리티어의 성능 한계로 인해 openclaw 커맨드가 매우 느리게 실행됩니다. onboard 실행 후 한참을 기다리면 설정이 시작되므로 인내심을 갖고 기다려야 합니다. 초기 설정 이후에는 꽤 빠른 응답속도를 보입니다.

OpenClaw onboard


Claude 구독 계정 연결

Claude Code에서 발급되는 토큰을 이용하여 Claude 구독 계정을 연결할 수 있습니다. onboard에서 Model/auth provider를 선택합니다:

Model/auth provider 선택

Anthropic을 선택하고 Anthropic 구독 계정을 setup-token 방식으로 인증한 후 토큰을 입력하면 됩니다.
토큰은 안내 멘트에 있는 명령을 수행하여 클로드 코드에서 받아옵니다.:

Anthropic setup-token 입력

토큰 발급

# Claude Code에서 키 발급 (로그인하면 토큰 발급됨)
claude setup-token

토큰 등록

클로드 코드 setup-token으로 생성한 코드를 onboard 설정 창에 입력합니다.
이미 onboard를 완료한 경우 아래 명령으로 설정을 다시 변경할 수 있습니다:

openclaw configure

모델 변경

설정 파일(~/.openclaw/openclaw.json)에서 직접 모델을 변경할 수 있습니다:

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5"
      }
    }
  }
}

또는 CLI로 변경:

openclaw config set agents.defaults.model.primary "anthropic/claude-sonnet-4-5"

텔레그램 봇 연결

onboard에서 채널 선택 시 Telegram을 선택합니다:

채널 선택

텔레그램 봇 토큰을 입력하면 연결됩니다. 텔레그램 봇 만드는 방법은 텔레그램 봇 만들기 가이드를 참고하세요.

텔레그램 봇 토큰 입력

pairing이 안된 경우 아래 명령을 이용하면 됩니다. 토큰 정보는 ~/.openclaw/openclaw.json에 저장됩니다.

openclaw pairing approve telegram XXXXXX

# Approved telegram sender XXXXXXXXXX.

주요 명령어

openclaw onboard       # 초기 설정 마법사
openclaw configure     # 설정 마법사만 실행
openclaw doctor        # 설정 문제 진단
openclaw doctor --fix  # 문제 자동 수정
openclaw logs          # 로그 확인
openclaw gateway       # 게이트웨이 실행
openclaw tui           # 터미널 UI
openclaw health        # 상태 확인

참고 자료