gcube에서 OpenClaw 설치 및 실행하기

0. 개요

이 문서는 gcube 워크로드 환경에서 Ollama 기반 gemma4:e4b 모델을 실행하고,
OpenClaw Gateway 및 Control UI를 구성하는 방법을 안내합니다.

gcube 워크로드 생성 및 배포
SSH 접속
Ollama gemma4:e4b 모델 다운로드
Node.js 및 npm 설치
OpenClaw 설치 및 온보딩
플러그인 의존성 설치
OpenClaw Gateway 실행
Telegram Pairing 승인
OpenClaw 프로세스 종료 및 확인
웹 대시보드 접속
설정 파일 확인 및 수정
웹 대시보드 설정 및 활용
문제 해결
보안 주의사항

1. 워크로드 생성 및 배포

항목	설정값
저장소유형	`도커허브`
컨테이너 이미지	`ollama/ollama:latest`
컨테이너 포트	`18789`
GPU선택	`RTX Series 선택`
기타옵션	`공유 메모리 4GB`

ollama/ollama:latest

참고: 18789 포트는 OpenClaw Gateway와 Control UI 접속에 사용됩니다.

스크린샷

2. SSH 접속

워크로드가 실행되면 gcube에서 제공하는 SSH 접속 방법에 따라
PuTTY 원격 접속 클라이언트를 통해 컨테이너에 접속합니다.

ssh <gcube에서 제공하는 SSH 접속 명령어>

SSH 접속

SSH 접속을 위해 공인 IP를 조회하여 등록한 뒤, SSH 접속 주소와 포트를 사용해 컨테이너에 접속합니다.
PuTTY 터미널이 정상적으로 실행되면 아이디와 패스워드로 로그인합니다.

PuTTY에서 붙여넣기는 마우스 오른쪽 클릭으로 할 수 있습니다.

PuTTY 접속

3. Ollama 모델 다운로드

ollama run gemma4:e4b

위 명령어는 gemma4:e4b 모델을 다운로드한 뒤 실행합니다.

gemma4 모델 다운로드

Ollama 채팅 화면에서는 /bye 명령어로 나갈 수 있습니다.

4. Node.js 및 npm 설치

OpenClaw 설치를 위해 Node.js, npm, git를 설치합니다.
터미널에서 아래의 순서대로 명령어를 실행합니다.

apt-get update && apt-get install -y curl git
curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt-get install -y nodejs

패키지 업데이트

명령어를 실행한 뒤 설치가 정상적으로 완료되었는지 확인합니다.

node -v
npm -v
git --version

5. OpenClaw 설치

OpenClaw 설치를 위해 npm을 사용합니다.
터미널에서 아래의 순서대로 명령어를 실행합니다.

npm i -g openclaw
openclaw onboard

OpenClaw 설치

OpenClaw 온보드

6. 플러그인 의존성 설치

openclaw onboard 실행 중 플러그인이 설치되지 않았다는 오류가 나오면,
npm 명령어로 필요한 플러그인 의존성을 설치한 뒤 다시 온보드를 실행합니다.

터미널에서 아래의 명령어를 실행합니다.

npm i -g @larksuiteoapi/node-sdk nostr-tools
npm i -g @slack/web-api
npm i -g @whiskeysockets/baileys

openclaw onboard

OpenClaw 온보드

온보드 설정 중 default model에서는 정확한 gemma4:e4b 모델을 선택해야 합니다.

7. OpenClaw Gateway 실행

온보드가 완료되면 OpenClaw Gateway를 실행하면 됩니다.
터미널에서 아래의 명령어를 실행합니다.

openclaw gateway

8. Telegram Pairing 승인

OpenClaw Gateway가 실행되면 Telegram 연결 요청이 표시됩니다.
Telegram에서 확인한 Pairing Code를 사용해 터미널에서 승인 명령어를 실행합니다.

openclaw pairing approve telegram <PAIRING_CODE>

Telegram Pairing

주의: Pairing Code는 외부에 노출하지 않도록 주의합니다.

9. OpenClaw 프로세스 종료 및 확인

OpenClaw Gateway를 재실행해야 하는 경우 기존 프로세스를 종료한 뒤 다시 실행합니다.

pkill -9 -f openclaw
ps -ef | grep openclaw
openclaw gateway

10. 웹 대시보드 접속

gcube 워크로드의 서비스 URL 또는 포트 접근 URL을 통해 OpenClaw Control UI에 접속합니다.

http://<서비스_URL>:18789

웹 대시보드 접속

11. 설정 파일 확인 및 수정

아래의 cat 명령어를 사용해 /root/.openclaw/openclaw.json 설정 파일을 작성합니다.
<YOUR_GATEWAY_TOKEN>, <YOUR_TELEGRAM_BOT_TOKEN>, <서비스_URL> 부분은
여러분이 실제로 사용하는 값으로 변경해야 합니다.

cat > /root/.openclaw/openclaw.json <<'EOF'
EOF

{
  "agents": {
    "defaults": {
      "workspace": "/root/.openclaw/workspace",
      "model": {
        "primary": "ollama/gemma4:e4b"
      },
      "models": {
        "ollama/gemma4:e4b": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "<YOUR_GATEWAY_TOKEN>"
    },
    "port": 18789,
    "bind": "lan",
    "controlUi": {
      "allowInsecureAuth": true,
      "allowedOrigins": [
        "http://<서비스_URL>:18789"
      ],
      "enabled": true,
      "dangerouslyDisableDeviceAuth": true
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send",
        "sms.search"
      ]
    },
    "tls": {
      "enabled": false,
      "autoGenerate": false
    }
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "tools": {
    "profile": "coding",
    "web": {
      "search": {
        "provider": "ollama",
        "enabled": true
      }
    }
  },
  "plugins": {
    "entries": {
      "ollama": {
        "enabled": true
      },
      "telegram": {
        "enabled": true
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434",
        "api": "ollama",
        "apiKey": "OLLAMA_API_KEY",
        "models": [
          {
            "id": "gemma4",
            "name": "gemma4",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 128000,
            "maxTokens": 8192,
            "compat": { "supportsUsageInStreaming": true }
          },
          {
            "id": "gemma4:e4b",
            "name": "gemma4:e4b",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 131072,
            "maxTokens": 8192,
            "compat": {
              "supportsTools": true,
              "supportsUsageInStreaming": true
            }
          }
        ]
      }
    }
  },
  "auth": {
    "profiles": {
      "ollama:default": {
        "provider": "ollama",
        "mode": "api_key"
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "groups": {
        "*": { "requireMention": true }
      },
      "botToken": "<YOUR_TELEGRAM_BOT_TOKEN>"
    }
  },
  "wizard": {
    "lastRunAt": "2026-05-03T15:32:24.907Z",
    "lastRunVersion": "2026.5.2",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "meta": {
    "lastTouchedVersion": "2026.5.2",
    "lastTouchedAt": "2026-05-03T15:32:25.021Z"
  }
}

12. 웹 대시보드 설정 및 활용

OpenClaw 웹 대시보드에서는 OpenClaw 설정을 확인하고 수정할 수 있으며,
연결된 기능을 이용해 OpenClaw를 직접 사용할 수 있습니다.

gcube 워크로드의 서비스 URL 또는 포트 접근 URL로 접속한 뒤 웹 대시보드 화면을 확인합니다.

http://<서비스_URL>:18789

OpenClaw 웹 대시보드

13. 문제 해결

문제	원인	해결 방법
웹 대시보드 접속 불가	Gateway `bind` 설정이 외부 접속에 맞지 않음	`bind` 값을 `lan`, `port` 값을 `18789`로 설정
Control UI 접속 차단	`controlUi.allowedOrigins` 설정이 서비스 URL과 다름	`allowedOrigins`에 `http://<서비스_URL>:18789` 추가
OpenClaw 명령어 실행 불가	npm 전역 설치 경로 문제	`npm i -g openclaw` 재실행 후 PATH 확인
플러그인 오류 발생	필요한 npm 패키지 누락	관련 패키지 전역 설치
모델 실행 실패	Ollama 모델 미다운로드	`ollama run gemma4:e4b` 실행
Pairing 실패	요청 ID 또는 코드 불일치	최신 pairing 요청을 다시 확인

OpenClaw는 자주 업데이트되는 서비스이므로 명령어, 설정 항목, 화면 구성이 변경될 수 있습니다.

문서와 다른 문제가 발생하면 OpenClaw 공식 문서를 먼저 확인하고,
오류 메시지와 현재 설정 내용을 정리해 Claude, Gemini, ChatGPT 등의 AI 서비스에 도움을 요청해 보세요.

14. 보안 주의사항

Gateway Token은 외부에 공개하지 않습니다.
Telegram Bot Token은 문서에 직접 입력하지 않습니다.
Pairing Code와 Request ID는 사용 후 문서에서 제거합니다.
allowedOrigins에는 여러분이 사용하는 http://<서비스_URL>:18789만 입력합니다.
allowInsecureAuth: true, dangerouslyDisableDeviceAuth: true, tls.enabled: false 설정은
테스트 환경에서만 사용하는 것을 권장합니다.