쓸모 쓸모연구소 · 실전 노트
제 825 호이번 주 새 글 49 편2026 · 11 · 14
로컬 LLM·AI 서버
OpenClaw · Ollama

이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.

오픈클로 Ollama 연결 방법, 맥 게이트웨이 오류 해결까지 91단계

오픈클로 Ollama 연결을 Mac에서 처음부터 끝까지 따라 하는 91단계입니다. OpenClaw 한 줄 설치, 임의 모델 이름으로 온보딩 통과, Ollama 앱 로그인, ollama launch openclaw로 실제 모델 연결, 그리고 중간에 터지는 "Gateway failed to start" 오류를 푸는 순서까지 담았습니다. Homebrew 준비와 제거 방법도 함께 넣었습니다.

오픈클로 Ollama 연결 방법, 맥 게이트웨이 오류 해결까지 91단계 삽화
삽화 · 쓸모연구소

오픈클로 Ollama 연결 전에 알아 둘 보안 경고

전체 흐름은 이렇습니다. openclaw.ai의 한 줄 설치 명령으로 OpenClaw를 깔고, 온보딩은 임의의 모델 이름으로 넘깁니다. 그다음 Ollama를 설치⁠·로그인하고 ollama launch openclaw로 실제 모델(minimax 2.5 cloud)을 연결합니다. 이 과정에서 "Gateway failed to start" 오류가 자주 나는데, 푸는 순서는 8장에 있습니다.

설치 중에는 보안 경고가 뜹니다. OpenClaw는 꽤 똑똑해서 주 운영체제에서 명령을 실행할 수 있고, 시스템을 망가뜨릴 가능성도 있습니다. 그래서 OpenClaw를 가상머신에서 돌려 보는 사용자가 많습니다.

경고문에 나오는 권장 사항은 이렇습니다.

  • OpenClaw는 취미 프로젝트이고 아직 베타다. 제한된 환경에서 실행하기를 권한다.
  • 권장 기준선은 샌드박스(바깥과 격리된 실행 공간) + 최소 권한 도구
  • 비밀 정보는 에이전트가 닿는 파일 영역 밖에 둔다.
  • 쓸 수 있는 가장 강력한 모델을 쓴다.

실제로 OpenClaw는 파일을 직접 만들고 시스템 명령을 실행해 Mac 사양을 읽어 냅니다(10장). Mac에서 가상머신을 쓰려면 UTM 같은 무료 가상화 앱에 macOS나 리눅스를 따로 올리는 방법이 있습니다. 번거롭다면 적어도 중요한 파일과 로그인 정보가 없는 사용자 계정을 새로 만들어 그 계정에서 설치하는 것부터 권합니다.

설치 도중에는 "node가 네트워크의 기기를 찾도록 허용"하는 팝업도 뜹니다(33단계). 이 권한은 같은 와이파이⁠·공유기 안의 다른 기기를 찾아 연결을 시도할 수 있게 해 주는 macOS 설정입니다. 허용하지 않아도 이 글의 절차(대시보드 채팅)는 내 Mac 안에서만 오가므로 진행에는 지장이 없는 경우가 많고, 나중에 시스템 설정의 개인정보 보호 및 보안 → 로컬 네트워크에서 바꿀 수 있습니다.

이 글에서 쓰는 모델은 Ollama 계정 로그인이 필요한 클라우드 모델입니다. 유료 LLM 구독을 쓴다면 대시보드의 사용량 화면을 자주 봐야 합니다. 클라우드 모델의 요금이나 무료 한도는 Ollama 공식 안내에서 직접 확인해야 합니다.

OpenClaw와 Ollama는 각각 무엇인가

OpenClaw는 오픈소스 AI 비서, 자율 에이전트 플랫폼입니다. 단순한 챗봇을 넘어 컴퓨터나 서버에서 실제 작업을 대신 해 줍니다.

  • OpenClaw: 명령을 실행하고 파일을 만들고 대화를 관리하는 에이전트 본체
  • Ollama: AI 모델을 받아 실행해 주는 프로그램. Mac에서는 메뉴 막대에 아이콘이 뜨는 앱 형태로도 돕니다.
  • 게이트웨이(gateway): OpenClaw가 뒤에서 켜 두는 중계 프로그램. 대시보드와 모델, 메신저 사이를 잇습니다.
  • TUI: Terminal User Interface. 터미널 창 안에서 AI 비서와 대화하는 화면입니다.

이 네 가지를 구분해 두면 8장의 오류가 왜 나는지 바로 이해됩니다. TUI와 새로 띄운 OpenClaw가 같은 게이트웨이 자리를 두고 부딪치는 겁니다.

맥 준비물: Homebrew, Node.js, Ollama 계정

  • Mac
  • 웹 브라우저, 인터넷 연결
  • Mac 로그인 비밀번호: Ollama 설치 중에 물을 수 있습니다.
  • Ollama 계정: Google 계정으로 로그인해 만들 수 있습니다.
  • Homebrew, Node.js: 없으면 OpenClaw 설치 명령이 대부분 알아서 설치해 줍니다.
  • (선택) 텍스트 편집기: Visual Studio Code 등

설치 명령에 맡기기가 불안하다면 Homebrew(맥용 프로그램 설치 관리자)를 먼저 깔아 두면 됩니다. 터미널에 아래 한 줄을 붙여 넣고 Enter를 누르면, Mac 비밀번호를 한 번 묻고 설치가 진행됩니다. brew.sh 첫 화면에 있는 공식 명령과 같습니다.

명령어
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew가 깔렸다면 Node.js(OpenClaw가 돌아가는 실행 환경)는 brew install node 한 줄로 설치됩니다. node -v를 입력해 버전 번호가 나오면 준비 끝입니다.

임의 모델 이름으로 온보딩을 넘기는 이유

온보딩 단계에서는 Ollama 모델을 고를 수 없어서, Ollama/ 뒤에 아무 모델 이름을 넣어 일단 온보딩을 끝냅니다. 그래서 TUI에 "hi"를 보내도 답이 없는 게 정상입니다. 그다음 Ollama를 설치하고 로그인한 뒤 ollama launch openclaw로 진짜 모델을 연결합니다.

이 마지막 단계에서 게이트웨이 충돌이 나는 경우가 많습니다. 아래 단계는 충돌이 나는 순서 그대로 두고, 푸는 법을 8장에 적었습니다. 충돌 없이 가고 싶다면 47단계에서 TUI를 미리 닫고(Ctrl+C) openclaw gateway stop까지 해 둔 뒤 7장으로 넘어가면 됩니다.

1. OpenClaw 설치 명령 가져오기

  1. 웹 브라우저를 연다.
    • 확인: 브라우저 창이 뜬다.
  2. "OpenClaw"를 검색한다.
    • 확인: 첫 번째 결과가 openclaw.ai 링크다.
  3. openclaw.ai 링크를 클릭한다.
    • 확인: OpenClaw 사이트가 열린다.
  4. 페이지를 아래로 조금 스크롤한다.
    • 확인: Quick Start 섹션이 보인다.
  5. Quick Start에서 one-liner를 찾는다.
    • 팁: npm, hackable, macOS 탭의 컴패니언 앱(베타, 메뉴바 접근)도 있습니다. 처음이라면 one-liner가 가장 간단합니다.
    • 확인: curl 명령이 보이고 "works on macOS, Windows, and Linux. The one-liner installs Node.js and everything else for you"(맥⁠·윈도우⁠·리눅스에서 되고, Node.js를 비롯한 필요한 것을 모두 설치해 준다) 문구가 있다.
  6. one-liner 명령을 복사한다.
    • 주의: 손으로 옮겨 치지 말고 사이트에 적힌 명령을 그대로 복사하는 게 가장 확실합니다.
    • 확인: 복사됐다.

OpenClaw 공식 Quick Start의 한 줄 설치 명령은 아래 형태입니다. 버전에 따라 바뀔 수 있으니 사이트 내용과 다르면 사이트를 따릅니다.

명령어
curl -fsSL https://openclaw.ai/install.sh | bash

2. 터미널에서 OpenClaw 설치

  1. 브라우저를 최소화한다.
    • 확인: 바탕화면이 보인다.
  2. Spotlight 검색을 클릭한다.
    • 위치: 화면 오른쪽 위 메뉴 막대의 돋보기 아이콘. 키보드로는 Cmd+Space입니다.
    • 확인: 검색창이 뜬다.
  3. "terminal"을 입력한다.
    • 확인: 결과에 Terminal이 나온다.
  4. Terminal을 클릭한다.
    • 확인: 터미널 창이 열린다.
  5. 복사한 명령을 붙여 넣는다.
    • 확인: curl 명령이 입력돼 있다.
  6. Enter를 누른다.
    • 확인: 설치가 시작되고 운영체제, 설치 방식, 요청 버전(latest)이 표시된다. 이어서 Homebrew와 Node.js를 확인한다.
  7. 설치가 끝날 때까지 기다린다.
    • 참고: 예전에는 설치와 온보딩이 따로였는데 지금은 한 줄 명령에 온보딩이 들어 있습니다.
    • 확인: npm으로 OpenClaw가 설치된 뒤 온보딩(OpenClaw onboarding)이 자동으로 시작되고 보안 경고가 뜬다.

온보딩이 자동으로 뜨지 않으면 openclaw onboard를 입력해 직접 시작합니다.

3. 오픈클로 온보딩 진행

온보딩은 설치에 이어 자동으로 진행됩니다. 순서를 바꿀 수 없습니다. 화살표 키로 고르고 Enter로 넘어갑니다.

  1. 보안 경고를 끝까지 읽는다.
    • 확인: 앞의 보안 경고 구획에 정리한 내용(베타, 샌드박스 + 최소 권한 도구, 비밀 정보 격리, 가장 강력한 모델)이 보인다.
    • 주의: OpenClaw는 주 운영체제에서 명령을 실행해 시스템을 망가뜨릴 가능성도 있습니다. 가능하면 가상머신이나 별도 사용자 계정에서 진행합니다.
  2. 화살표 키로 Yes에 이동한다.
    • 위치: "I understand this is a powerful and inherently risky…"(강력하고 본질적으로 위험하다는 걸 이해한다) 질문
    • 확인: Yes가 선택된다.
  3. Enter를 누른다.
    • 확인: 온보딩 모드 선택 화면이 나온다.
  4. QuickStart를 선택한다.
    • 확인: QuickStart가 선택된다.
  5. Enter를 누른다.
    • 확인: 모델 목록이 나온다.
  6. "Skip for now"(지금은 건너뛰기)를 선택한다.
    • 확인: Skip for now가 선택된다. 모델은 Ollama에서 받을 것이라 목록의 모델은 쓰지 않습니다.
  7. Enter를 누른다.
    • 확인: "Filter model by provider"(제공자별 모델 거르기) 화면이 나온다.
  8. "All providers"를 선택하고 Enter를 누른다.
    • 확인: 다음 목록이 나온다.
  9. "Enter model manually"(모델 이름 직접 입력)를 선택한다.
    • 확인: 해당 옵션이 선택된다.
  10. Enter를 누른다.
    • 확인: 모델 이름 입력칸이 나온다.
  11. (선택) 브라우저에서 ollama.com/library를 연다.
    • 참고: 모델 이름을 참고하려는 것뿐입니다. 예를 들어 deepseek 계열의 deepseek R1 같은 이름을 고를 수 있습니다.
    • 확인: 인기 모델 목록이 보인다.
  12. 입력칸에 Ollama/ 뒤에 아무 모델 이름을 붙여 입력한다.
    • 주의: 일부러 넣는 임의 이름입니다. 온보딩만 끝내려는 것이고 실제 모델은 7장에서 연결합니다. 예를 들어 ollama/deepseek-r1처럼 넣으면 됩니다.
    • 확인: 입력칸에 이름이 보인다.
  13. Enter를 누른다.
    • 확인: 채널 선택 화면이 나온다.
  14. 채널에서 "Skip for now"를 클릭한다.
    • 확인: Skip for now가 선택된다.
  15. Enter를 누른다.
    • 확인: "Configure skills"(스킬 설정) 화면이 나온다.
  16. No를 선택한다.
    • 확인: No가 선택된다. 스킬은 나중에 설정할 수 있습니다.
  17. Enter를 누른다.
    • 확인: "Enable hooks" 화면이 나온다.
  18. 스페이스 키를 눌러 "Skip for now"를 선택한다.
    • 주의: 이 화면은 "press space to select, enter to submit"(스페이스로 고르고 Enter로 제출)입니다. 다른 화면처럼 Enter부터 누르면 선택이 되지 않습니다.
    • 확인: Skip for now가 선택된다.
  19. Enter를 눌러 선택을 제출한다.
    • 확인: "Installing gateway"가 뜨고 gateway 설치, 서비스 시작으로 이어진다.
  20. "Allow node to find devices on your network" 팝업에서 Allow를 클릭한다.
    • 주의: 기기의 네트워크 탐색 권한을 주는 팝업입니다. 뜻과 거절했을 때의 영향은 앞의 보안 구획에 정리했습니다.
    • 확인: 팝업이 닫힌다.
  21. "How do you want to hatch your bot"(봇을 어디서 깨울까)에서 기본값 "Hatch in TUI"를 그대로 두고 Enter를 누른다.
    • 참고: TUI는 Terminal User Interface, 터미널 안에서 AI 비서를 쓰는 방식입니다.
    • 확인: 터미널 안 AI 비서 화면(TUI)이 열리고 "noodling" 같은 문구가 보인다.
  22. TUI에 "hi"를 입력한다.
    • 확인: 입력됐다.
  23. Enter를 누른다.
    • 확인: 연결은 돼 있습니다. 다만 임의 모델이라 답이 없는 게 정상입니다.

4. 토큰과 대시보드 URL 저장

웹 채팅을 열려면 토큰이 붙은 전체 URL이 있어야 하니 파일에 저장해 둡니다. 토큰은 대시보드에 들어가는 비밀 열쇠이니 다른 사람에게 보여 주지 않습니다.

  1. TUI 출력에서 token 부분을 찾는다.
    • 확인: 게이트웨이 토큰이 openclaw.json에 저장돼 있다는 안내가 보인다.
  2. 터미널을 위로 조금 스크롤한다.
    • 확인: 토큰 값과 웹 채팅용 전체 URL이 보인다.
  3. 전체 URL을 복사한다.
    • 주의: 토큰은 사람마다 다른 값입니다. 화면 캡처를 남에게 보낼 때도 가립니다.
    • 확인: 복사됐다.
  4. 아무 파일이나 하나 연다.
    • 확인: 빈 파일이 열린다. Mac 기본 앱인 텍스트 편집기(TextEdit)나 메모 앱이면 충분합니다.
  5. 복사한 URL을 붙여 넣는다.
    • 확인: 파일에 URL이 보인다. 나중에 웹 채팅을 열 때 이 주소를 씁니다.
  6. (확인용) 토큰 안내 부분의 openclaw.json 경로를 복사한다.
    • 확인: 경로가 복사됐다.
  7. 터미널을 우클릭한다.
    • 위치: Dock의 터미널 아이콘을 우클릭하면 같은 메뉴가 나옵니다. 터미널이 앞에 있을 때 Cmd+N을 눌러도 새 창이 열립니다.
    • 확인: 메뉴가 뜬다.
  8. New Window를 클릭한다.
    • 확인: 새 터미널 창이 열린다.
  9. 아래 형식으로 cat 명령을 입력한다. 경로 부분에는 42단계에서 복사한 것을 붙여 넣는다.
프롬프트
cat <42단계에서 복사한 openclaw.json 경로>
  • 확인: 명령줄에 cat과 경로가 입력돼 있다. cat은 파일 내용을 화면에 그대로 보여 주는 명령입니다. 46. Enter를 누른다.
    • 확인: JSON 내용과 gateway token 값이 보인다.
    • 팁: cat 대신 open과 경로를 입력하면 기본 편집기로 열립니다. Visual Studio Code가 기본 편집기라면 그 창이 열립니다.
프롬프트
open <42단계에서 복사한 openclaw.json 경로>

URL을 적어 두지 못했어도 다시 열 수 있습니다. 터미널에서 openclaw dashboard를 입력하면 토큰이 붙은 대시보드 주소를 다시 열어 줍니다.

5. 맥에 Ollama 설치

  1. 첫 번째 터미널(TUI)은 그대로 둔다.
    • 주의: 이 TUI가 켜져 있으면 뒤의 76단계에서 "Gateway failed to start"가 납니다. 오류를 피하고 싶다면 여기서 Ctrl+C로 TUI를 닫고 openclaw gateway stop까지 해 둡니다.
    • 확인: TUI 창이 열려 있다.
  2. 브라우저에서 ollama.com을 연다.
    • 확인: 홈페이지에 설치 명령이 보인다.
  3. 설치 명령 옆 복사 버튼을 클릭한다.
    • 확인: 복사됐다.
  4. 브라우저를 최소화한다.
    • 확인: 바탕화면이 보인다.
  5. Spotlight에서 "terminal"을 검색한다.
    • 확인: 결과에 Terminal이 나온다.
  6. Terminal을 클릭한다.
    • 확인: 터미널 창이 열린다.
  7. 복사한 명령을 붙여 넣는다.
    • 주의: ollama.com 홈의 설치 명령은 curl과 셸 스크립트 주소로 된 아래 형태입니다. 사이트 내용과 다르면 사이트를 따릅니다.
    • 확인: 명령이 입력돼 있다.
명령어
curl -fsSL https://ollama.com/install.sh | sh
  1. Enter를 누른다.
    • 확인: Ollama를 내려받아 설치한다.
  2. Mac 비밀번호를 물으면 입력한다.
    • 확인: 입력됐다. 비밀번호를 칠 때 화면에 글자가 보이지 않는 게 정상입니다.
  3. Enter를 누른다.
    • 확인: "Starting Ollama", "Install complete. You can now run Ollama"가 나온다. 백그라운드 실행 알림도 뜬다.

명령줄이 부담스럽다면 ollama.com의 Download 버튼으로 Mac용 앱 파일을 받아 응용 프로그램 폴더로 옮기는 방식도 같은 결과입니다.

6. Ollama 앱에서 로그인

  1. apps(응용 프로그램) 목록을 연다.
    • 확인: Ollama 아이콘이 보인다.
  2. Ollama 아이콘을 클릭한다.
    • 확인: Ollama 그래픽 화면(GUI)이 열린다.
  3. 모델 선택 목록을 연다.
    • 확인: 위쪽은 클라우드 모델, 아래로 내리면 다운로드 아이콘이 붙은 로컬 모델이 보인다.
  4. 클라우드 모델 하나를 선택한다. 예시는 Minimax M2다.
    • 확인: "Ollama 계정에 로그인해야 한다"는 메시지가 뜬다.
  5. Sign in 버튼을 클릭한다.
    • 확인: Ollama 로그인 페이지가 열린다.
  6. Google 계정으로 로그인한다.
    • 확인: 계정이 만들어진다.
  7. Connect를 클릭한다.
    • 확인: "Device connected successfully"가 뜬다.
  8. Ollama 앱의 채팅 화면으로 돌아간다.
    • 확인: 메시지를 보낼 수 있는 상태다.

클라우드 모델은 계산을 Ollama 서버에서 하고, 로컬 모델은 내 Mac 메모리 안에서 돌립니다. 비용과 개인정보를 생각하면 로컬 모델이 유리하지만, 모델 파일을 내려받아야 하고 메모리가 적은 Mac에서는 느릴 수 있습니다.

7. ollama launch openclaw로 모델 연결

  1. 브라우저에서 ollama.com을 연다.
    • 확인: 홈페이지가 열린다.
  2. 홈페이지를 아래로 스크롤한다.
    • 확인: OpenClaw 항목이 보인다.
  3. OpenClaw 항목을 클릭한다.
    • 확인: "Your open-source AI assistant, OpenClaw, automates your work" 문구와 실행 명령이 보인다.
  4. 실행 명령을 복사한다.
    • 확인: 복사됐다.
  5. 터미널을 우클릭한다.
    • 확인: 메뉴가 뜬다.
  6. New Window를 클릭한다.
    • 확인: 새 터미널 창이 열린다.
  7. 명령을 붙여 넣는다.
명령어
ollama launch openclaw
  • 확인: 명령이 입력돼 있다. Ollama가 OpenClaw 설정에 모델을 적어 넣고 OpenClaw를 대신 띄워 주는 명령입니다. 72. Enter를 누른다.
    • 확인: 설치된 모델이 없어서 추천 모델 목록이 나온다. 73. 스페이스 키로 추천 모델을 선택한다.
    • 확인: 해당 모델이 기본 선택된다. 74. Enter를 누른다.
    • 확인: "Download minimax 2.5:cloud?" 질문이 나온다. 75. Yes를 그대로 두고 Enter를 누른다.
    • 확인: MiniMax를 받아오고 "backup will be saved here"(기존 설정의 백업을 여기에 저장한다) 안내가 나온다. 76. Enter를 한 번 더 누른다.
    • 확인: "Launching OpenClaw with MiniMax"가 나온다.
    • 주의: 첫 터미널의 TUI를 켜 둔 상태라면 여기서 "Gateway failed to start"가 납니다. TUI가 같은 포트를 쓰고 있기 때문입니다. 해결은 바로 다음 8장입니다.

8. "Gateway failed to start" 오류 해결

포트(port)는 한 컴퓨터 안에서 프로그램마다 쓰는 출입문 번호입니다. OpenClaw 게이트웨이는 18789번 문을 쓰는데, 이미 켜진 게이트웨이가 그 문을 잡고 있으면 새 게이트웨이가 들어가지 못해 이 오류가 납니다.

순서가 고정입니다. TUI 종료, 게이트웨이 중지, ollama launch openclaw 재실행 순으로 갑니다.

  1. 첫 번째 터미널(TUI가 돌고 있는 창)로 간다.
    • 확인: TUI 화면이 보인다.
  2. Ctrl+C를 누른다.
    • 참고: Ctrl+C는 두 번 필요할 수 있습니다(인스턴스 종료, 인터페이스에서 나오기). 한 번에 빠져나오지 않으면 한 번 더 누릅니다.
    • 확인: TUI에서 빠져나온다.
  3. 게이트웨이 중지 명령을 입력한다.
명령어
openclaw gateway stop
  • 확인: 명령이 입력돼 있다. 오류가 났을 때 OpenClaw가 직접 권하는 명령이기도 합니다. 80. Enter를 누른다.
    • 확인: "stopped launch agent" 문구가 나오고 게이트웨이가 멈춘다. launch agent는 macOS가 뒤에서 자동으로 켜 두는 서비스를 가리킵니다. 81. ollama launch openclaw를 썼던 터미널로 간다.
    • 확인: 그 터미널이 앞에 있다. 아무 터미널 창에서 실행해도 됩니다. 82. ollama launch openclaw를 다시 입력한다.
명령어
ollama launch openclaw
  • 확인: 명령이 입력돼 있다. 위쪽 화살표 키를 누르면 방금 쓴 명령을 다시 불러올 수 있습니다. 83. Enter를 누른다.
    • 확인: 이번에는 정상 실행되고 게이트웨이가 시작된다.

그래도 같은 오류가 반복되면 18789번을 누가 잡고 있는지 확인해 봅니다. 아래 명령은 해당 포트를 쓰는 프로그램 이름과 번호(PID)를 보여 줍니다.

프롬프트
lsof -i :18789

목록에 남은 OpenClaw나 node 프로그램이 보이면 그 창을 닫거나 openclaw gateway stop을 한 번 더 실행한 뒤 83단계를 반복합니다.

9. 웹 대시보드 열기

  1. 41단계에서 저장해 둔 토큰 포함 전체 URL을 복사한다.
    • 확인: 복사됐다. 호스트와 포트는 127.0.0.1:18789이고 토큰이 있어야 들어갈 수 있습니다.
  2. 브라우저 주소창에 붙여 넣는다.
    • 확인: 주소창에 URL이 보인다.
  3. Enter를 누른다.
    • 확인: OpenClaw gateway 대시보드(웹 채팅)가 열린다.
  4. Overview 창을 확인한다.
    • 확인: WebSocket 연결, 토큰 값(URL에 넣은 것), 언어(English), 실행 중인 인스턴스 수가 보인다.

10. 오픈클로 동작 테스트

  1. 채팅창에 아래 문장을 입력한다.
프롬프트
write a C++ program
  • 확인: 입력됐다. 아주 간단한 hello world 프로그램을 만들어 보는 시험입니다. 89. Enter를 누른다.
    • 확인: Minimax 모델이 답을 만들고, hello.cpp 파일을 실제로 만든 뒤 컴파일⁠·실행 명령을 추천한다. 90. 아래 문장을 입력한다.
프롬프트
list my computer's configuration and specification
  • 확인: 입력됐다. 91. 메시지를 보낸다.
    • 확인: 여러 명령을 실행한 뒤 MacBook 사양(칩, 메모리, 저장공간, 디스플레이 등)을 보여 준다. Mac이라고 알려 주지 않아도 스스로 찾아냅니다.

한국어로 시험하고 싶다면 아래처럼 물어도 됩니다. 첫 시험은 파일을 지우거나 바꾸지 않는 요청으로 합니다.

프롬프트
내 Mac의 칩, 메모리, 남은 저장공간을 알려 줘. 어떤 명령을 실행했는지도 같이 보여 줘. 파일은 만들거나 지우지 마.

OpenClaw는 파일을 실제로 만들고, 명령을 여러 개 돌려 내 기기 정보를 읽어 옵니다. 앞에서 가상머신을 권한 이유가 여기서 드러납니다.

11. 오픈클로 대시보드 메뉴 둘러보기

따라 할 단계는 아니고, 테스트 전에 대시보드에서 볼 수 있는 메뉴입니다.

  • 채널: 아직 연결된 채널은 없다. WhatsApp, Telegram 등을 여기서 연결할 수 있다.
  • 인스턴스, 세션, 사용량: 유료 LLM 구독이라면 토큰과 일일 사용량을 볼 때 중요합니다.
  • 크론 잡(정해진 시각에 자동으로 도는 작업), 에이전트 목록
  • 모델 목록: Primary model은 Ollama minimax-2.5. 온보딩 때 넣은 임의 모델은 동작하지 않습니다.
  • 파일: agents.md 같은 에이전트 공통 파일
  • 스킬: 내장 스킬이 50개 들어 있습니다. 1Password 등이 있습니다.
  • Nodes(페어링된 기기, TUI), Debug, Logs(게이트웨이 로그)
  • 문서(documentation): 동작 방식을 설명한 문서 페이지로 이어진다. 이 글의 절차는 간단한 퀵스타트이고, 전체 기능은 문서에 있습니다.

오픈클로 Ollama 연결 점검표

  • 설치 뒤 온보딩이 자동으로 시작됐는가 (13단계)
  • 보안 경고를 읽고 동의했는가 (14~16단계)
  • 토큰 포함 전체 URL을 파일에 저장했는가 (41단계)
  • Ollama "Install complete"를 봤는가 (56단계)
  • Ollama 앱에서 "Device connected successfully"를 봤는가 (63단계)
  • TUI 종료와 openclaw gateway stop 뒤 ollama launch openclaw가 정상 실행됐는가 (78~83단계)
  • 브라우저에 OpenClaw gateway 대시보드가 열렸는가 (86단계)
  • 채팅으로 Mac 사양을 물었을 때 실제 정보가 나왔는가 (91단계)

오픈클로 Ollama 연결이 막히면

  • Hooks 화면에서 Enter를 눌러도 선택이 안 된다: 이 화면은 스페이스로 선택하고 Enter로 제출합니다.
  • TUI에 "hi"를 보내도 답이 없다: 온보딩 때 임의 모델 이름을 넣었기 때문입니다. 5~8장대로 Ollama 모델을 연결합니다.
  • ollama launch openclaw 뒤 "Gateway failed to start": 다른 터미널의 OpenClaw TUI가 같은 포트를 쓰고 있어서입니다. 그 터미널에서 Ctrl+C, openclaw gateway stop, 재실행 순으로 풉니다.
  • 대시보드가 안 열린다: 토큰 없이 127.0.0.1:18789만 열었을 수 있습니다. 토큰이 붙은 전체 URL을 쓰거나 openclaw dashboard로 다시 엽니다.
  • 클라우드 모델을 고르면 로그인을 요구한다: 클라우드 모델은 Ollama 계정이 있어야 합니다. Sign in, Google 로그인, Connect 순으로 진행합니다.
  • openclaw 명령을 찾을 수 없다고 나온다: 설치 직후 터미널이 새 경로를 아직 읽지 않은 경우가 많습니다. 터미널 창을 닫고 새로 연 뒤 다시 입력합니다.

오픈클로 제거와 메신저 연결

게이트웨이만 잠시 멈추려면 TUI에서 Ctrl+C를 누르고 openclaw gateway stop을 실행하면 됩니다.

완전히 지우고 싶을 때는 OpenClaw에 들어 있는 제거 명령을 씁니다. 실행하면 지울 항목 목록이 뜨고, 스페이스로 고른 뒤 확정합니다. Ollama 앱은 메뉴 막대 아이콘에서 종료한 뒤 응용 프로그램 폴더에서 휴지통으로 옮기면 됩니다.

명령어
openclaw uninstall

메신저를 붙이고 싶다면 대시보드의 채널 메뉴나 터미널의 openclaw channels add에서 WhatsApp, Telegram 등을 고르면 됩니다. 연결 절차는 온보딩의 채널 단계와 같은 흐름입니다.

오픈클로 Ollama 연결 핵심 순서

설치 한 줄, 임의 모델로 온보딩 통과, Ollama 설치와 로그인, ollama launch openclaw. Mac에서는 Spotlight로 터미널을 열고, Ollama 앱(GUI)에서 계정 로그인을 하는 과정이 끼어 있습니다.

실제로 막힐 가능성이 큰 곳은 8장입니다. 온보딩 끝에 연 TUI를 켜 둔 채 ollama launch openclaw를 돌리면 포트가 겹칩니다. TUI 종료, 게이트웨이 중지, 재실행 순서만 지키면 풀립니다. 그리고 시스템을 망가뜨릴 수도 있는 도구라서 가상머신이나 별도 계정에서 돌리라는 경고가 붙어 있다는 점은 설치 전에 한 번 더 생각해 볼 만합니다.

자주 묻는 질문

오픈클로에서 Gateway failed to start 오류는 왜 나나요?

이미 켜져 있는 OpenClaw(TUI나 게이트웨이 서비스)가 같은 포트를 잡고 있어서입니다. 온보딩 끝에 연 TUI를 그대로 둔 경우가 가장 흔합니다. TUI 창에서 Ctrl+C로 빠져나오고, openclaw gateway stop을 실행한 뒤 ollama launch openclaw를 다시 돌리면 풀립니다.

오픈클로 온보딩에서 Ollama 모델을 바로 고를 수 없나요?

온보딩의 모델 목록에는 Ollama 모델이 없어서, "Enter model manually"로 Ollama/ 뒤에 아무 이름을 넣고 넘어갑니다. 실제 모델은 나중에 ollama launch openclaw가 설정 파일에 적어 넣습니다. 그 전까지 채팅이 답하지 않는 건 정상입니다.

Ollama 클라우드 모델을 쓰면 요금이 드나요?

minimax 2.5 cloud 같은 클라우드 모델은 Ollama 계정 로그인이 필요하고, 무료 한도와 요금은 Ollama 공식 안내에서 확인해야 합니다. 외부 요금 없이 쓰려면 이름에 cloud가 없는 로컬 모델을 고르면 되지만, Mac 메모리에 따라 속도가 느릴 수 있습니다.

대시보드 토큰 주소를 잃어버리면 어떻게 하나요?

openclaw.json 파일 안에 gateway token 값이 저장돼 있습니다. 터미널에서 cat과 파일 경로로 열어 확인하거나, openclaw dashboard를 입력해 토큰이 붙은 주소를 다시 엽니다. 토큰은 대시보드 열쇠이니 다른 사람에게 보여 주지 않습니다.

이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.

원본 영상 보러가기 ↗