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

Unraid 시스템에서 Ollama의 Locam LLM 서비스를 이용하여 OpenClaw를 동작시켜봅시다.

• Ollama는 이미 설치되어 서비스 중인 것을 전제로 합니다.
• 외부 접근(역방향 프록시 등)에 대한 설명은 생략합니다.

OpenClaw 컨테이너 설치하기

Apps에서 OpenClaw를 검색하여 Official 컨테이너를 다운로드 합니다.

도커 설정은 기본값에서 몇가지 건드려야 합니다.

해당 레포지토리 버전은 기본값이 latest 최신버전으로 설정되어 있습니다.

🔥주의! 최신버전의 OpenClaw는 Discord 서버/채널에서 응답받지 못하는 버그를 확인하였습니다 -> ghcr.io/openclaw/openclaw:2026.4.15 버전은 Discord의 정상 응답 확인하였습니다.

본 게시물에서는 Discord와 연동을 목표로 하기 때문에 안정된 버전인 openclaw:2026.4.15 버전으로 설치합니다.

컨테이너의 내부와 연결할 Unraid 경로를 설정해야합니다.

기본경로는 /mnt/user ... 으로 설정되어 있습니다만,

Unraid의 고질병으로 일부 도커 서비스에서는 Web-Socket 이슈가 발생할 수 있습니다...😅

/mnt/user -> /mnt/cache 로 변경해줍니다.

해당 /mnt/cache 경로의 폴더에는 소유자, 권한 설정을 추가해줍니다.

chown -R 99:100 /mnt/cache/appdata/openclaw
chmod -R 777 /mnt/cache/appdata/openclaw

Gateway 설정하기

OpenClaw는 외부 접근 시, Gateway를 이용합니다.

외부에서 OpenClaw에 연결하려면 SSL 설정이 되어 있어야합니다.

(저는 역방향 프록시, 인증서를 통해 외부에서는 https로 접속하고, OpenClaw의 http 경로로 연결하였습니다.)

Gateway에서의 보안항목으로 Token 설정할 경우, openssl 생성키를 사용합니다.

Unraid 터미널에서 아래 명령어를 입력하면 Token을 생성할 수 있습니다.

잘 메모해둡시다. (나중에 쓸 수 있어요 😄)

openssl rand -hex 24

컨테이너 설치가 끝나면 Gateway 추가 설정을 직접 해줍니다.

nano /mnt/cache/appdata/openclaw/config/openclaw.json

"controlUi"의 "dangerouslyAllowHostHeaderOriginFallback": true 를 추가해줍니다.

이게 없을 경우 역방향 프록시 접근이 안 됩니다;

"gateway": {
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowInsecureAuth": true,
      "dangerouslyAllowHostHeaderOriginFallback": true
    },
    "auth": {
      "mode": "token"
    }
  },

설정이 끝나면 컨테이너를 재시작 합니다.

OpenClaw 접속하기

OpenClaw 웹페이지에 접속하면 Gateway 대시보드가 나타납니다.

위에서 생성했던 OpenSSL 키를 Gateway 토큰란에 입력합니다.

혹은, 웹주소에 직접 토큰을 입력할 수도 있습니다.

http://[Unraid_내부_IP]:18789/?token=1단계에서_발급받은_48자리_토큰

토큰값이 컨테이너의 세팅값과 일치한다면, Device Pairing을 해야한다는 알림이 나타납니다.

requestid를 복사합니다.

Unraid 터미널을 열고 아래 명령어를 입력하거나,

docker exec -it OpenClaw openclaw devices approve [device-paring-requied-ID]
docker exec -it OpenClaw openclaw onboard

OpenClaw 콘솔에서 직접 'openclaw devices approve [페어링ID]' 명령어를 입력합니다.

OpenClaw 설정하기

페어링이 완료되면 본격적으로 OpenClaw 초기세팅을 할 차례입니다! 🤖

아래 OpenClaw Onboard 명령어를 입력하면 Setup이 시작됩니다.

openclaw onboard

Yes로 바꾸고 Enter를 누르면 다음 스텝을 진행합니다.

저는 QuickStart로 진행하였습니다.

• Ollama의 IP주소와 기본 LLM 모델을 선택합니다.
• Channel은 Discord를 선택합니다.

설정이 끝나면 OpenClaw 웹링크로 접속합니다.

Ollama의 로컬모델로 gemma4를 사용하였는데 잘 연결된 것을 확인하였습니다.

첫 채팅을 시도하면 OpenClaw의 성격, 정체성 등 구체적인 설정들을 진행합니다.

채팅창에서 프롬프트만으로 OpenClaw가 이해하고 직접 설정을 마치는 과정을 경험할 수 있습니다.

Discord Bot 추가하기

Discord에 OpenClaw를 연결하면, 앱으로 메시지를 보내서 명령하거나 상태 등을 확인할 수 있습니다.

Discord 계정이 있다는 가정하에 Bot 추가를 진행하겠습니다.

아래 개발자 포털 페이지에 들어갑니다.

Discord for Developers

Build games, experiences, and integrations for millions of users on Discord.

Discord Developer Portal

[New Application] 버튼을 클릭하여 OpenClaw 봇을 생성합니다.

내 애플리케이션에 생성한 봇을 클릭하여 세부 설정을 진행합니다.

• 왼쪽 탭에서 봇 메뉴를 클릭합니다.

• [토큰 초기화] 버튼을 클릭하여 Discord 봇의 토큰을 생성합니다.

• 🔥주의! 토큰은 현재 이 화면에서만 볼 수 있습니다! 잘 복사해 둡니다.

화면을 내리면, 봇의 기본 세팅 항목들이 나타납니다.

Privileged Gateway Intents의 모든 Intent 항목들을 활성화합니다.

[변경 사항 저장] 버튼을 클릭합니다.

왼쪽 탭의 OAuth2 메뉴를 클릭합니다.

OAuth2 URL 생성기에서 편의상 '스코프: bot', '봇 권한: 관리자'로 설정합니다.

📌 OpenClaw 가이드에는 bot, applications.commands와 View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Add Reactions를 설정합니다;;

맨 아래에 생성된 URL의 주소를 복사합니다.

웹페이지에 주소창에 생성된 URL로 접속합니다.

생성한 Bot을 서버에 추가합니다.

Discord 앱 연결하기

📳Discord 앱 - 설정 - 개발자 - 개발자 모드 를 활성화 해줍니다.

OpenClaw Bot 전용 서버와 채널을 생성합니다.

미리 채널을 만든 상태에서 위 Bot 추가를 진행하였다면, 자동으로 채널에 OpenClaw Bot이 입장하는 것을 확인할 수 있습니다.

채널에서 Bot과 대화하려면 '@'로 해당 Bot 계정을 선택한 상태에서 대화를 진행해야 합니다.

귀찮다면 config 파일에서 해제할 수 있습니다.

Unraid 터미널에서 아래 config 파일을 수정합니다.

nano /mnt/cache/appdata/openclaw/config/openclaw.json

"discord" 항목에서 "requireMention":false를 추가해줍니다.

  "channels": {
    "discord": {
      "enabled": true,
      "token": "[Discord Bot 토큰]",
      "groupPolicy": "open",
      "guilds": {
        "*": {
          "requireMention": false,
          "channels": {
            "*": { "allow": true, "requireMention": false }
          }
        }
      }
    }
  },

'@' 태그 없이도 채널에서 잘 대답하는 것을 확인할 수 있습니다.

DM(Direct Message) 연결하기

🔥DM(Direct Message)을 쉽게 연결하려면, 입장한 Bot 계정을 클릭합니다.

[+ 앱 추가] 버튼을 클릭하여 직접 Bot에게 메시지를 보내면, GUI로 간단히 DM 설정을 마칠 수 있습니다.

처음 Bot에게 DM을 보내면 페어링을 위한 코드와 명령어를 대답합니다.

OpenClaw 콘솔창을 열어서 해당 명령어를 복사하여 실행하면 등록이 완료됩니다.

• openclaw config 명령어를 이용하여 서버ID/채널ID를 설정하는 방법
• config 파일의 discord - channels에 직접 서버ID/채널ID를 등록하는 방법

다중 Agent 추가 & Open WebUI 연결

Uraid에서 Apps로 설치한 OpenClaw는 기본적으로 1개의 Agent만 등록할 수 있습니다.

만약 다양한 유형의 Agent들을 관리하고 싶다면 약간의 편법을 사용할 수 있습니다.

nano /mnt/cache/appdata/openclaw/config/openclaw.json

  "gateway": {
    "mode": "local",
    "bind": "lan",
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    },
    ...
  },
  "agents": {
    "defaults": {
      "workspace": "/root/.openclaw/workspace",
      "model": {
        "primary": "ollama/gemma4:26b-a4b-it-q4_K_M"
      },
      "models": {
        "ollama/gemma4:26b-a4b-it-q4_K_M": {
          "streaming": false
        },
        "ollama/lfm2.5-thinking:1.2b-bf16": {
          "streaming": false
        }
      }
    },
    "list": [
      {
        "id": "main",
        "model": "ollama/gemma4:26b-a4b-it-q4_K_M"
      },
      {
        "id": "light",
        "model": "ollama/lfm2.5-thinking:1.2b-bf16"
      }
    ]
  },

agent - list에 Agent들을 등록할 수 있습니다.

Agent들은 생성 시, 기본 workspace가 default의 workspace/Agent 이름의 폴더 경로를 따르므로 각기 다른 workspace를 운영하고 싶다면 폴더를 생성해줘야 합니다.

# 1. main 워크스페이스 위치 아래에 light 폴더 생성
mkdir -p /mnt/cache/appdata/openclaw/config/workspace/light

# 2. main workspace에 있는 원본 파일들을 light 폴더로 복사
cp /mnt/cache/appdata/openclaw/config/workspace/*.md /mnt/cache/appdata/openclaw/config/workspace/light/

# Agent 별 다른 인격 부여
nano /mnt/cache/appdata/openclaw/config/workspace/light/SOUL.md

# 3. 권한 부여
chown -R 99:100 /mnt/cache/appdata/openclaw/config/workspace/light
chmod -R 777 /mnt/cache/appdata/openclaw/config/workspace/light

Open WebUI 연결하기

• Open WebUI를 이미 설치한 상태를 가정합니다.

기본적인 OpenClaw의 웹UI 화면에서는 채팅창이 1개 뿐입니다.

내부 드롭박스를 통해 각 세션 별, 모델 별 선택은 가능하지만 기능적으로 많이 부족합니다.

각 Agent 별 다른 채팅창을 사용하기 위해 Open WebUI를 사용해보겠습니다.

OpenClaw config 파일의 gateway 항목에 아래 http 설정을 추가합니다.

• 이 설정이 없을 경우 OpenClaw에서 Open WebUI로 모델 정보를 전달할 수 없습니다.

  "gateway": {
    "mode": "local",
    "bind": "lan",
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    },

제대로 설정이 적용되었는지 확인해 봅시다.

# curl -H "Authorization: Bearer [OpenClaw-Token]" http://127.0.0.1:18789/v1/models

아래처럼 모델 정보들이 출력된다면 정상적으로 적용된 것입니다.

이제 Open WebUI를 설정합니다.

설정 - 관리자 설정 - 연결 화면으로 이동합니다.

OpenClaw는 OpenAI API 방식으로 통신하므로 OpenAI API에 연결을 추가합니다.

OpenClaw의 IP/v1으로 URL 주소를 입력하고 인증키에 처음 OpenSSL로 만들었었던 토큰키를 입력합니다.

새로고침 버튼을 누르면 실제 연결이 되는지 테스트 결과가 팝업창이 나타납니다.

채팅창의 모델 선택 항목에 openclaw config로 직접 추가했던 모델 리스트가 나타난다면 성공입니다.

각 추가한 모델들이 각기 다른 Agent의 역할을 하는 지 테스트 해보려는데,

workspace만 다를 뿐이지 Agent의 성격 같은 것은 default 값을 공유하는 느낌입니다만, 각 Agent의 SOUL.md 파일을 설정하면 적용되지 않을까 합니다;;

🔥이 부분은 제대로 확인하지 않았습니다... 그냥 너무 비효율적이라서 사용을 안 할 것 같군요 😭

Cron 작업 추가하기 (OpenClaw - Heartbeat 사용)

Discord에 일기예보 채널을 생성하여 매일 아침마다 오늘의 날씨를 알려주는 기능을 만들어 봅시다🌞

Agent니까 위에서 연결한 Open WebUI를 통해 일기예보를 Discord로 알려주는 스케쥴을 지시했습니다.

Agent 스스로 Cron 작업을 생성하고 Discord 채널로 전달하도록 설정까지 완료하는 게 신기합니다.

실제로 Discord에 생성한 일기예보 채널에 날씨 설명이 보내진 것을 확인할 수 있었습니다.

이러한 Agent의 스케쥴링하는 작업을 Cron이라고 부릅니다.

위처럼 프롬프트를 이용해서 Agent에게 Cron 작업을 생성하도록 지시도 가능하지만,

OpenClaw Control을 통해 세부 설정을 직접할 수 있습니다.

Control - Cron 작업 탭을 클릭합니다.

등록된 작업 리스트를 확인하거나 추가, 수정할 수 있습니다.

우측에서 새 작업을 만들거나, 기존 작업의 편집 버튼을 클릭하여 내용을 수정할 수 있습니다.

수정 후, 정해진 시간이 되자 OpenClaw가 열심히 날씨 정보를 수집해서 Discord로 메시지를 날려준 모습입니다.

참 기특하네요. 🦀

마무리

OpenClaw를 처음부터 설치하고 Ollama의 로컬 모델과 연동해서 돌려보기까지 꽤나 긴 여정이였습니다 😀

ChatGPT나 Gemini, Claude 같은 API를 사용하는 LLM보다는 물론 성능면에서 떨어지겠지만,

최근 나온 gemma4, qwen3.6의 성능도 많이 올라온 상태에서

Claude 스타일이나 MoE 같은 기술들이 적용되니 이제는 Local 모델도 충분히 쓸만한 것 같습니다.

OpenClaw 설정에서 Web Search 기능도 적절히 붙여서 실시간 정보들을 취합하고 분석하도록 시키면 개인용 AI Agent로 꽤나 그럴듯한 성능을 만들 수 있지 않을까 싶네요 😺

추후에는 Hermes Agent나 Coding Agent들도 다뤄보고 비교해보겠습니다.