"오픈클로를 시놀로지에 설치해서 API와 Discord까지 연동하기" 입니다 😄

시놀로지는 로컬 llm을 돌리기엔 HW 사양이 부족하기에 예제로 Gemini API를 연결하여 OpenClaw를 동작 해보겠습니다.

컨테이너 매니저 - 레지스트리 기본 설치

1. 시놀로지 - 컨테이너 매니저 - 레지스트리

2. OpenClaw 이미지 다운로드

검색창에서 OpenClaw를 검색하면 많은 이미지들이 나옵니다.

가장 별표가 많은 alpine/openclaw를 다운 받겠습니다.

3. 컨테이너 생성

이미지 다운로드가 완료되면 컨테이너 생성을 합니다.

컨테이너 -> 생성 버튼 클릭

리소스 제한은 시놀로지 사양 및 오픈클로 용도에 맞게 적절히 선택해줍니다.

OpenClaw는 기본적으로 18789 포트를 사용합니다.

로컬포트와 컨테이너 포트(18789)를 맞춰줍니다.

다운 받은 alpine/openclaw의 경우 /home/node를 시놀로지에서 생성한 /docker/openclaw 폴더와 매핑합니다.

환경변수로 PUID(1026), GUI(100)를 추가합니다.

컨테이너 생성을 완료합니다.

4. OpenClaw 설정 편집

아직 OpenClaw 설정이 마쳐진 상태가 아니므로 빌드 후 실행 시, 강제종료 됩니다.

컨테이너를 중단하고 설정하기 위해, 시놀로지 터미널을 실행하고 SSH에 접속합니다.

sudo -i
cd /volume1/docker/openclaw/.openclaw/
vim openclaw.json

openclaw.json은 OpenClaw의 외부 접속 관련하여 설정을 관리합니다.

vim에서 i키로 편집모드로 전환하여 설정을 진행합니다.

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "{OpenClaw Token}"
    },
    "mode":"local",
    "bind":"lan",

    "controlUi": {
      "allowedOrigins": [
        "http://localhost:18789",
        "http://127.0.0.1:18789",
        "https://{URL}:18789"
        ]
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.5.4",
    "lastTouchedAt": "2026-05-06T08:11:39.681Z"
  }
}                         

OpenClaw는 보안 때문에 외부접근에 대해 매우 엄격합니다.

기본적으로는 localhost와 https를 통한 접근만이 허용됩니다.

만약, 내부망에서 http로 접근 시에는

OpenClaw Gateway에 HTTP API를 열어주는 설정인

"http": {
  "endpoints": {
    "chatCompletions": { "enabled": true },
    "responses": { "enabled": true }
  }
}

"dangerouslyDisableDeviceAuth": true
"allowInsecureAuth": true

를 적용해줘야 합니다.

모두 적용한 예시는 아래와 같습니다.

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "{OpenClaw Token}"
    },
    "mode":"local",
    "bind":"lan",

    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
          },
        "responses": {
          "enabled": true
        }
      }
    },

    "controlUi": {
      "dangerouslyDisableDeviceAuth": true,
      "dangerouslyAllowHostHeaderOriginFallback": true,
      "allowedOrigins": [
        "http://localhost:18789",
        "http://127.0.0.1:18789",
        "http://{IP}:18789",
        "http://{URL}:18789"
        ]
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.5.4",
    "lastTouchedAt": "2026-05-06T08:11:39.681Z"
  }
}                         

본인의 네트워크 설정에 맞게 구성하시면 됩니다.

vim에서 저장 후 나가기는

:qw

입니다.

chown -R 1000:1000 /volume1/docker/openclaw

최종적으로 폴더 권한을 변경합니다.

Docker-Compose 한방셋 설치하기

1. NAS에 폴더 만들기

File Station이나 SSH에 접속하여 /volume1/docker에 openclaw 폴더를 생성합니다.

/volume1
└── docker
    └── openclaw
        ├── config
        ├── workspace
        └── auth-secrets

mkdir -p /volume1/docker/openclaw/config
mkdir -p /volume1/docker/openclaw/workspace
mkdir -p /volume1/docker/openclaw/auth-secrets

OpenClaw 컨테이너가 기본적으로 node 사용자, uid 1000으로 실행되기 때문에 권한을 수정해줍니다.

(공식 문서도 bind mount 권한 문제 시 uid 1000 소유권을 맞추라고 안내합니다.)

Docker · OpenClaw

Optional Docker-based setup and onboarding for OpenClaw

OpenClaw

chown -R 1000:1000 /volume1/docker/openclaw

2. /volume1/docker/openclaw/.env 만들기

OpenClaw 폴더에 .env 파일을 만듭니다.

Docker-Compose 시 환경변수를 전달하기 위한 용도입니다.

먼저 OpenClaw에 사용할 토큰을 생성합니다.

토큰은 고유정보이니 절대 까먹거나 타인에게 보여주면 안 됩니다! 🚨

토큰 생성을 위해서 시놀로지 제어판에서 터미널을 열어주고 SSH에 접속합니다.

그리고 SSH에서 openssl 난수 생성을 이용해 토큰을 생성합니다.

cd /volume1/docker/openclaw
openssl rand -hex 32

나온 값을 .env 파일의 OPENCLAW_GATEWAY_TOKEN에 넣어 저장합니다.

OPENCLAW_GATEWAY_TOKEN=여기에_랜덤_토큰_붙여넣기
OPENCLAW_TZ=Asia/Seoul
OPENCLAW_DISABLE_BONJOUR=1
OPENCLAW_GATEWAY_BIND=lan

(OpenClaw 공식 Docker 문서에 따르면 Docker 설치에서는 .env에 Gateway 토큰을 쓰고, OPENCLAW_DISABLE_BONJOUR 같은 Docker용 환경변수도 사용합니다.)

3. Container Manager에서 Project 생성

DSM에서 Container Manger 앱을 실행합니다.

Container Manager → Project → Create

프로젝트 이름, 경로를 지정하고 Docker-Compose(YAML)는 직접 생성합니다.

Project name: openclaw
Path: /volume1/docker/openclaw
Source: Create docker-compose.yml

그리고 아래 compose를 편집창에 복사해줍니다.🔰

이 compose는 공식 compose의 핵심 구조만 Synology용으로 줄인 것입니다.

공식 compose은 ghcr.io/openclaw/openclaw:latest 같은 pre-built 이미지를 사용할 수 있고, config/workspace/auth secret 디렉터리를 컨테이너 안의 OpenClaw 경로로 bind mount, 18789, 18790 포트를 게시합니다.

밑에 예시는 도커 image는 alpine/openclaw:latest로 선택했는데 다른 공식이나 시놀로지에 맞는 오픈클로 이미지가 있다면 바꾸셔도 괜찮을 겁니다.?

services:
  openclaw:
    #image: ghcr.io/openclaw/openclaw:latest
    image: alpine/openclaw:latest
    env_file:
      - .env

    environment:
      HOME: /home/node
      OPENCLAW_HOME: /home/node
      TERM: xterm-256color

      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_CONFIG_DIR: /home/node/.openclaw
      OPENCLAW_WORKSPACE_DIR: /home/node/.openclaw/workspace

      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_DISABLE_BONJOUR: ${OPENCLAW_DISABLE_BONJOUR:-1}
      TZ: ${OPENCLAW_TZ:-Asia/Seoul}

    volumes:
      - /volume1/docker/openclaw/config:/home/node/.openclaw
      - /volume1/docker/openclaw/workspace:/home/node/.openclaw/workspace
      - /volume1/docker/openclaw/auth-secrets:/home/node/.config/openclaw

    ports:
      - "127.0.0.1:18789:18789"
      - "127.0.0.1:18790:18790"

    extra_hosts:
      - "host.docker.internal:host-gateway"

    cap_drop:
      - NET_RAW
      - NET_ADMIN

    security_opt:
      - no-new-privileges:true

    init: true
    restart: unless-stopped

    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "lan",
        "--port",
        "18789"
      ]

    healthcheck:
      test:
        [
          "CMD",
          "node",
          "-e",
          "fetch('http://127.0.0.1:18789/healthz').then((r)=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
        ]
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 20s

4. 프로젝트는 일단 만들고, 실행됐으면 중지

Container Manager가 프로젝트 생성 후 컨테이너를 빌드하면 바로 실행될 수 있습니다. 실행됐다면 바로 중지해줍니다.

Container Manager → Project → openclaw → Stop

OpenClaw는 초기 Onboard라는 세팅작업이 필요하기 때문에 바로 실행해도 정상동작하지 않을 겁니다.💦

SSH를 이용해서 Docker-Compose 이미지를 먼저 받습니다.

cd /volume1/docker/openclaw/
docker compose pull

Compose를 실행하여 OpenClaw 명령어로 Onboard를 실행합니다.

docker compose run --rm --no-deps --entrypoint node openclaw \
  dist/index.js onboard --mode local --no-install-daemon

그다음 Gateway 기본 설정을 합니다.

docker compose run --rm --no-deps --entrypoint node openclaw \
  dist/index.js config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"},{"path":"gateway.controlUi.allowedOrigins","value":["http://localhost:18789","http://127.0.0.1:18789","https://OpenClaw 대시보드 URL:18789"]}]'

OpenClaw는 보안에 때문에 Gateway 접근이 매우 엄격? 합니다.

먼저 여기서 NAS_IP는 실제 NAS IP 혹은 URL는 실제 ssl URL 이어야 합니다.

예시:

docker compose run --rm --no-deps --entrypoint node openclaw \
  dist/index.js config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"},{"path":"gateway.controlUi.allowedOrigins","value":["http://localhost:18789","http://127.0.0.1:18789","https://synoclaw.pinblog.me"]}]'

대시보드 화면 결과

openclaw.json 설정이 완료되었으면, 컨테이너 매니저에서 다시 openclaw 컨테이너를 실행해줍니다.

그리고 브라우저에 시놀로지 IP(내부망) or URL(https) 입력하여 대시보드에 접속합니다.

앞서 .env에 저장했던 Gateway 토큰을 입력하고 연결해줍니다.

만약, 위처럼 https, localhost를 연결하라고 나온다면 OpenClaw에서 보안문제로 막고 있는 상태입니다.

앞서 openclaw.json 설정을 확인하고 현재 네트워크망 상태에 맞게 설정하시기 바랍니다.

가장 간편한 방법은 OpenClaw 메시지처럼 localhost나 https에서의 접속을 해야합니다.

복잡하지만, OpenClaw 공식 문서도 수동 설치 흐름에서 openclaw에 --entrypoint node를 줘서 onboarding과 config set을 먼저 실행한 뒤 gateway를 올리는 방식을 안내합니다.

정상적으로 접근하였다면,

이처럼 device 페어링을 하라는 알람창이 나타납니다.
일반적으로 OpenClaw에 등록되지 않은 Device (접속한 웹 브라우저, PC, 스마트폰, 태블릿 등)에서는 페어링을 해야된다는 에러메시지가 나타납니다.😥

이때, 나타나는 RequiredID가 중요합니다. 현재 OpenClaw에 접속한 Device에 대한 식별ID입니다.

알람창에서 안내하는 페어링 방법을 순차적으로 실행하면 페어링이 완료됩니다.

여기서는 Docker-Compose 기준으로 설명하겠습니다.

SSH에서 다음 명령어를 입력하면 현재 OpenClaw에 등록/대기 중인 Device 리스트가 나타납니다.

docker compose exec openclaw openclaw devices list

대기중인 Device가 현재 대시보드에 접속한 장치가 맞는지 확인합니다.

대시보드 알람창에 RequiredID가 일치해야 합니다! 🚨

docker compose exec openclaw openclaw devices approve [Required ID]

를 입력해서 OpenClaw가 승인했다는 로그가 나타나면 성공입니다!

다시 한번,

docker compose exec openclaw openclaw devices list

를 사용해보면 대기 중이던 Device가 승인된 것을 확인할 수 있습니다.

다시 브라우저에 접속해보면 정상적으로 OpenClaw 대시보드에 접속된 것을 확인할 수 있습니다! 😉

이제 Device 페어링은 끝났으니 Onboard를 통해 OpenClaw의 기본 설정만 마치면 됩니다! :)

5. OpenClaw Onboard

여기부터는 ssh 터미널에 접속해서 좀 수작업이 필요합니다.

OpenClaw의 초기화작업인 onboard 명령어로 설정을 진행합니다.

방법1. 컨테이너 매니저의 터미널 사용

컨테이너 매니저에서 OpenClaw 컨테이너의 작업버튼을 클릭하여 터미널을 열어줍니다.

터미널 창에서 생성버튼을 클릭하여 bash를 엽니다.

openclaw onboard

OpenClaw의 Onboard 화면이 나타나면 성공입니다.

방법2. SSH로 Docker/Docker-Compose에서 실행

시놀로지 SSH로 접속하여 /docker/openclaw 맵핑 폴더로 이동하여 도커에서 openclaw onboard 명령어를 실행합니다.

예시) Docker-Compose로 진행한 경우,

sudo -i
cd /volume1/docker/openclaw
docker compose exec openclaw openclaw onboard

이렇게 OpenClaw setup 화면이 나타난다면 성공입니다.

6. Onboard 세팅

🖥️Unraid + 🦀OpenClaw(🐋Docker) + 🦙Ollama(🤖Local Model)

Unraid 시스템에서 Ollama의 Locam LLM 서비스를 이용하여 OpenClaw를 동작시켜봅시다. * Ollama는 이미 설치되어 서비스 중인 것을 전제로 합니다. * 외부 접근(역방향 프록시 등)에 대한 설명은 생략합니다. OpenClaw 컨테이너 설치하기 Apps에서 OpenClaw를 검색하여 Official 컨테이너를 다운로드 합니다. 도커 설정은 기본값에서 몇가지 건드려야 합니다. 해당 레포지토리 버전은 기본값이 latest 최신버전으로 설정되어 있습니다.

PINBlogPINB

이후 OpenClaw Onboard 설정 방법은 위 게시글을 참고해주세요.

감사합니다. :)