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

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

오픈클로 Ollama 연결 전에: 화자가 직접 한 보안 경고

ProgrammingKnowledge 채널의 25분짜리 영어 튜토리얼이 바탕입니다. 화자는 openclaw.ai의 한 줄 설치 명령으로 OpenClaw를 깔고, 온보딩은 임의의 모델 이름으로 넘긴 뒤, Ollama를 설치·로그인하고 ollama launch openclaw로 실제 모델(minimax 2.5 cloud)을 연결합니다. 중간에 "Gateway failed to start" 오류를 만나 해결하는 장면도 그대로 나옵니다.

설치 중 뜨는 보안 경고에 화자가 자기 말을 보탭니다. 자신은 OpenClaw를 보통 가상머신에서 써 본다고요. 이유는 OpenClaw가 꽤 똑똑해서 주 운영체제에서 명령을 실행할 수 있고, "시스템을 망가뜨릴 가능성도 있기" 때문이라고 합니다.

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

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

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

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

비용 이야기는 거의 없습니다. 화자가 고른 건 Ollama 계정 로그인이 필요한 클라우드 모델이고, 유료 LLM 구독이라면 대시보드의 사용량 화면이 중요하다고만 말합니다. 클라우드 모델의 요금이나 무료 한도는 Ollama 공식 안내에서 직접 확인해야 합니다.

화자는 Homebrew나 Node.js를 직접 설치하고 싶은 사람을 위해 자기 채널의 별도 영상 링크를 설명란에 둔다고 안내합니다. 자기 채널 영상으로 이어지는 안내라는 점은 알고 보시면 됩니다.

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 설치

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

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

3. 오픈클로 온보딩 진행

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

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

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

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

37. TUI 출력에서 token 부분을 찾는다.
    • 확인: 게이트웨이 토큰이 openclaw.json에 저장돼 있다는 안내가 보인다.
38. 터미널을 위로 조금 스크롤한다.
    • 확인: 토큰 값과 웹 채팅용 전체 URL이 보인다.
39. 전체 URL을 복사한다.
    • 주의: URL 형식은 영상 화면에서 읽지 못했고, 토큰 값은 이 글에 옮기지 않았습니다.
    • 확인: 복사됐다.
40. 아무 파일이나 하나 연다.
    • 확인: 빈 파일이 열린다. Mac 기본 앱인 텍스트 편집기(TextEdit)나 메모 앱이면 충분합니다.
41. 복사한 URL을 붙여 넣는다.
    • 확인: 파일에 URL이 보인다. 나중에 웹 채팅을 열 때 필요하다고 합니다.
42. (확인용) 토큰 안내 부분의 openclaw.json 경로를 복사한다.
    • 확인: 경로가 복사됐다.
43. 터미널을 우클릭한다.
    • 위치: 화자는 "right click on the terminal"이라고만 말합니다. Dock의 터미널 아이콘을 우클릭하면 같은 메뉴가 나옵니다. 터미널이 앞에 있을 때 Cmd+N을 눌러도 새 창이 열립니다.
    • 확인: 메뉴가 뜬다.
44. New Window를 클릭한다.
    • 확인: 새 터미널 창이 열린다.
45. 아래 형식으로 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 설치

47. 첫 번째 터미널(TUI)은 그대로 둔다.
    • 주의: 원문 순서대로 둡니다. 그런데 이 TUI가 켜져 있어서 뒤의 76단계에서 "Gateway failed to start"가 났다고 화자가 나중에 설명합니다. 오류를 피하고 싶다면 여기서 Ctrl+C로 TUI를 닫고 openclaw gateway stop까지 해 둡니다.
    • 확인: TUI 창이 열려 있다.
48. 브라우저에서 ollama.com을 연다.
    • 확인: 홈페이지에 설치 명령이 보인다.
49. 설치 명령 옆 복사 버튼을 클릭한다.
    • 확인: 복사됐다.
50. 브라우저를 최소화한다.
    • 확인: 바탕화면이 보인다.
51. Spotlight에서 "terminal"을 검색한다.
    • 확인: 결과에 Terminal이 나온다.
52. Terminal을 클릭한다.
    • 확인: 터미널 창이 열린다.
53. 복사한 명령을 붙여 넣는다.
    • 주의: 화자는 "curl -fSSL(자막 표기)과 셸 스크립트 링크"라고만 읽습니다. ollama.com 홈의 설치 명령은 아래 형태이고, 사이트 내용과 다르면 사이트를 따릅니다.
    • 확인: 명령이 입력돼 있다.

curl -fsSL https://ollama.com/install.sh | sh

54. Enter를 누른다.
    • 확인: Ollama를 내려받아 설치한다.
55. Mac 비밀번호를 물으면 입력한다.
    • 확인: 입력됐다. 비밀번호를 칠 때 화면에 글자가 보이지 않는 게 정상입니다.
56. Enter를 누른다.
    • 확인: "Starting Ollama", "Install complete. You can now run Ollama"가 나온다. 백그라운드 실행 알림도 뜬다.

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

6. Ollama 앱에서 로그인

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

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

7. ollama launch openclaw로 모델 연결

65. 브라우저에서 ollama.com을 연다.
    • 확인: 홈페이지가 열린다.
66. 홈페이지를 아래로 스크롤한다.
    • 확인: OpenClaw 항목이 보인다.
67. OpenClaw 항목을 클릭한다.
    • 확인: "Your open-source AI assistant, OpenClaw, automates your work" 문구와 실행 명령이 보인다.
68. 실행 명령을 복사한다.
    • 확인: 복사됐다.
69. 터미널을 우클릭한다.
    • 확인: 메뉴가 뜬다.
70. New Window를 클릭한다.
    • 확인: 새 터미널 창이 열린다.
71. 명령을 붙여 넣는다.

ollama launch openclaw

• 확인: 명령이 입력돼 있다. 화자는 "Ollama launch open claw"라고 읽습니다. Ollama가 OpenClaw 설정에 모델을 적어 넣고 OpenClaw를 대신 띄워 주는 명령입니다. 72. Enter를 누른다.
  • 확인: 설치된 모델이 없어서 추천 모델 목록이 나온다. 73. 스페이스 키로 추천 모델을 선택한다.
  • 확인: 해당 모델이 기본 선택된다. 74. Enter를 누른다.
  • 확인: "Download minimax 2.5:cloud?" 질문이 나온다. 자막에는 "minimax 2.5 colon cloud"로 찍혀 있습니다. 75. Yes를 그대로 두고 Enter를 누른다.
  • 확인: MiniMax를 받아오고 "backup will be saved here"(기존 설정의 백업을 여기에 저장한다) 안내가 나온다. 76. Enter를 한 번 더 누른다.
  • 확인: "Launching OpenClaw with MiniMax"가 나온다.
  • 주의: 화자 환경에서는 여기서 "Gateway failed to start"가 났습니다. 첫 터미널의 TUI가 같은 포트를 쓰고 있었기 때문이라고 설명합니다. 해결은 바로 다음 8장입니다.

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

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

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

77. 첫 번째 터미널(TUI가 돌고 있는 창)로 간다.
    • 확인: TUI 화면이 보인다.
78. Ctrl+C를 누른다.
    • 참고: 화자는 Ctrl+C를 두 번 언급합니다(인스턴스 종료, 인터페이스에서 나오기). 한 번에 빠져나오지 않으면 한 번 더 누릅니다.
    • 확인: TUI에서 빠져나온다.
79. 게이트웨이 중지 명령을 입력한다.

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. 웹 대시보드 열기

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

10. 오픈클로 동작 테스트

88. 채팅창에 아래 문장을 입력한다.

write a C++ program

• 확인: 입력됐다. 자막 기준 문구이고, 화자는 "아주 간단한 hello world 프로그램"을 만들려 한다고 말합니다. 89. Enter를 누른다.
  • 확인: Minimax 모델이 답을 만들고, hello.cpp 파일을 실제로 만든 뒤 컴파일·실행 명령을 추천한다. 90. 아래 문장을 입력한다.

list my computer's configuration and specification

• 확인: 입력됐다. 91. 메시지를 보낸다.
  • 확인: 여러 명령을 실행한 뒤 MacBook 사양(칩, 메모리, 저장공간, 디스플레이 등)을 보여 준다. 화자는 Mac이라고 알려 주지 않았는데도 찾아냈다고 강조합니다.

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

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

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

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

따라 할 단계는 아니고, 화자가 테스트 전에 둘러본 메뉴입니다.

• 채널: 아직 연결된 채널은 없다. WhatsApp, Telegram 등을 여기서 연결할 수 있다.
• 인스턴스, 세션, 사용량: 유료 LLM 구독이라면 토큰과 일일 사용량을 볼 때 중요하다고 합니다.
• 크론 잡(정해진 시각에 자동으로 도는 작업), 에이전트 목록
• 모델 목록: Primary model은 Ollama minimax-2.5. 온보딩 때 넣은 임의 모델은 동작하지 않는다고 합니다.
• 파일: agents.md 같은 에이전트 공통 파일
• 스킬: 화자는 내장 스킬이 50개라고 말합니다. 1Password(자막 표기 "one password") 등이 있습니다.
• 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 명령을 찾을 수 없다고 나온다: 설치 직후 터미널이 새 경로를 아직 읽지 않은 경우가 많습니다. 터미널 창을 닫고 새로 연 뒤 다시 입력합니다.

되돌리는 방법(제거·원복)은 영상에 나오지 않습니다. 발화된 건 게이트웨이 중지 명령 openclaw gateway stop과 Ctrl+C뿐입니다. Homebrew와 Node.js를 따로 설치하는 방법은 화자 채널의 다른 영상으로 넘겼고, WhatsApp이나 Telegram 연결도 "이 과정을 따라 하면 된다"는 말로만 끝납니다.

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

openclaw uninstall

메신저를 붙이고 싶다면 대시보드의 채널 메뉴나 터미널의 openclaw channels add에서 Telegram 등을 고르면 됩니다.

오픈클로 Ollama 연결 핵심 순서

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

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

이 글은 ProgrammingKnowledge 채널 영상(25분 33초)의 영어 자동 자막을 기준으로 정리했고 화면은 대조하지 못했습니다. 고유명사와 명령어 표기가 정확하지 않을 수 있으며, 자막에 "OpenCL", "OpenCore", "open cloth"로 찍힌 이름은 문맥상 모두 OpenClaw로 옮겼습니다. Homebrew 설치 명령, OpenClaw·Ollama 설치 명령 원문, 포트 확인과 제거 방법은 편집자가 공식 안내를 바탕으로 보충했습니다.

출처: youtu.be/…