DigitalOcean

DigitalOcean 문서는 OpenClaw 공식 문서(install/digitalocean)를 한국어로 정리한 가이드입니다. Host OpenClaw on a DigitalOcean Droplet 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Host OpenClaw on a DigitalOcean Droplet

한국어 가이드 범위: install/digitalocean 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

사전 요구사항
설정
Persistence and backups
1 GB RAM tips
트러블슈팅
다음 단계
관련 문서

상세 내용

본문

Run a persistent OpenClaw Gateway on a DigitalOcean Droplet (~$6/month for the 1 GB Basic plan).

주요 항목:

Hetzner -- more cores/RAM per dollar.
Oracle Cloud -- Always Free ARM tier (up to 4 OCPU, 24 GB RAM), but signup can be finicky and it is ARM-only.

사전 요구사항

주요 항목:

DigitalOcean account (signup)
SSH key pair (or willingness to use password auth)
About 20 minutes

설정

Use a clean base image (Ubuntu 24.04 LTS). Avoid third-party Marketplace 1-click images unless you have reviewed their startup scripts and firewall defaults.

주요 항목:

Region: Closest to you
Image: Ubuntu 24.04 LTS
Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
Authentication: SSH key (recommended) or password

ssh root@YOUR_DROPLET_IP

    apt update && apt upgrade -y

    # Install Node.js 24
    curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
    apt install -y nodejs

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

    # Create the non-root user that will own OpenClaw state and services.
    adduser openclaw
    usermod -aG sudo openclaw
    loginctl enable-linger openclaw

    su - openclaw
    openclaw --version

openclaw onboard --install-daemon

fallocate -l 2G /swapfile
    chmod 600 /swapfile
    mkswap /swapfile
    swapon /swapfile
    echo '/swapfile none swap sw 0 0' >> /etc/fstab

openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f

Persistence and backups

These survive Droplet reboots. To take a portable snapshot:

주요 항목:

~/.openclaw/ -- openclaw.json, channel/provider credentials, per-agent auth-profiles.json, and session data.
~/.openclaw/workspace/ -- the agent workspace (SOUL.md, memory, artifacts).

openclaw backup create

1 GB RAM tips

The $6 Droplet only has 1 GB RAM. To keep things smooth:

주요 항목:

Make sure the swap step above is in /etc/fstab so it survives reboots.
Prefer API-based models (Claude, GPT) over local ones -- local LLM inference does not fit in 1 GB.
Set agents.defaults.model.primary to a smaller model if you hit OOMs on large prompts.
Monitor with free -h and htop.

트러블슈팅

Gateway will not start -- Run openclaw doctor --non-interactive and check logs with journalctl --user -u openclaw-gateway.service -n 50.

Port already in use -- Run lsof -i :18789 to find the process, then stop it.

Out of memory -- Verify swap is active with free -h. If still hitting OOM, switch to API-based models (Claude, GPT) rather than local models, or upgrade to a 2 GB Droplet.

다음 단계

주요 항목:

Channels -- connect Telegram, WhatsApp, Discord, and more
Gateway configuration -- all config options
Updating -- keep OpenClaw up to date

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/digitalocean
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

ssh root@YOUR_DROPLET_IP

    apt update && apt upgrade -y

    # Install Node.js 24
    curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
    apt install -y nodejs

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

    # Create the non-root user that will own OpenClaw state and services.
    adduser openclaw
    usermod -aG sudo openclaw
    loginctl enable-linger openclaw

    su - openclaw
    openclaw --version

openclaw onboard --install-daemon

fallocate -l 2G /swapfile
    chmod 600 /swapfile
    mkswap /swapfile
    swapon /swapfile
    echo '/swapfile none swap sw 0 0' >> /etc/fstab

openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f

# From your local machine
    ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

curl -fsSL https://tailscale.com/install.sh | sudo sh
    sudo tailscale up
    openclaw config set gateway.tailscale.mode serve
    openclaw gateway restart

DigitalOcean

핵심 요약

Host OpenClaw on a DigitalOcean Droplet

한국어 가이드 범위: install/digitalocean 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

사전 요구사항
설정
Persistence and backups
1 GB RAM tips
트러블슈팅
다음 단계
관련 문서

상세 내용

본문

Run a persistent OpenClaw Gateway on a DigitalOcean Droplet (~$6/month for the 1 GB Basic plan).

주요 항목:

Hetzner -- more cores/RAM per dollar.
Oracle Cloud -- Always Free ARM tier (up to 4 OCPU, 24 GB RAM), but signup can be finicky and it is ARM-only.

사전 요구사항

주요 항목:

DigitalOcean account (signup)
SSH key pair (or willingness to use password auth)
About 20 minutes

설정

Use a clean base image (Ubuntu 24.04 LTS). Avoid third-party Marketplace 1-click images unless you have reviewed their startup scripts and firewall defaults.

주요 항목:

Region: Closest to you
Image: Ubuntu 24.04 LTS
Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
Authentication: SSH key (recommended) or password

ssh root@YOUR_DROPLET_IP

    apt update && apt upgrade -y

    # Install Node.js 24
    curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
    apt install -y nodejs

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

    # Create the non-root user that will own OpenClaw state and services.
    adduser openclaw
    usermod -aG sudo openclaw
    loginctl enable-linger openclaw

    su - openclaw
    openclaw --version

openclaw onboard --install-daemon

fallocate -l 2G /swapfile
    chmod 600 /swapfile
    mkswap /swapfile
    swapon /swapfile
    echo '/swapfile none swap sw 0 0' >> /etc/fstab

openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f

Persistence and backups

These survive Droplet reboots. To take a portable snapshot:

주요 항목:

~/.openclaw/ -- openclaw.json, channel/provider credentials, per-agent auth-profiles.json, and session data.
~/.openclaw/workspace/ -- the agent workspace (SOUL.md, memory, artifacts).

openclaw backup create

1 GB RAM tips

The $6 Droplet only has 1 GB RAM. To keep things smooth:

주요 항목:

Make sure the swap step above is in /etc/fstab so it survives reboots.
Prefer API-based models (Claude, GPT) over local ones -- local LLM inference does not fit in 1 GB.
Set agents.defaults.model.primary to a smaller model if you hit OOMs on large prompts.
Monitor with free -h and htop.

트러블슈팅

Gateway will not start -- Run openclaw doctor --non-interactive and check logs with journalctl --user -u openclaw-gateway.service -n 50.

Port already in use -- Run lsof -i :18789 to find the process, then stop it.

Out of memory -- Verify swap is active with free -h. If still hitting OOM, switch to API-based models (Claude, GPT) rather than local models, or upgrade to a 2 GB Droplet.

다음 단계

주요 항목:

Channels -- connect Telegram, WhatsApp, Discord, and more
Gateway configuration -- all config options
Updating -- keep OpenClaw up to date

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/digitalocean
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

ssh root@YOUR_DROPLET_IP

    apt update && apt upgrade -y

    # Install Node.js 24
    curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
    apt install -y nodejs

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

    # Create the non-root user that will own OpenClaw state and services.
    adduser openclaw
    usermod -aG sudo openclaw
    loginctl enable-linger openclaw

    su - openclaw
    openclaw --version

openclaw onboard --install-daemon

fallocate -l 2G /swapfile
    chmod 600 /swapfile
    mkswap /swapfile
    swapon /swapfile
    echo '/swapfile none swap sw 0 0' >> /etc/fstab

openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f

# From your local machine
    ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

curl -fsSL https://tailscale.com/install.sh | sudo sh
    sudo tailscale up
    openclaw config set gateway.tailscale.mode serve
    openclaw gateway restart

DigitalOcean

핵심 요약

문서 구성

상세 내용

본문

사전 요구사항

설정

Persistence and backups

1 GB RAM tips

트러블슈팅

다음 단계

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

DigitalOcean

핵심 요약

문서 구성

상세 내용

본문

사전 요구사항

설정

Persistence and backups

1 GB RAM tips

트러블슈팅

다음 단계

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드