맥미니 M4 깡통을 24시간 AI 비서로! 오픈클로(OpenClaw) 설치

오픈클로(OpenClaw) 설치 가이드

맥미니 M4 기본형(깡통), M4 칩의 놀라운 성능과 전력 효율 덕분에,
이 작은 기기는 24시간 깨어있는 나만의 개인용 AI 서버가 되기에 충분합니다.

'오픈클로(OpenClaw)'를 맥미니 M4에 설치하여, 디스코드에서 언제든 대화할 수 있는
똑똑한 AI 비서를 만드는 방법을 아주 상세하게 알려드리겠습니다.

복잡해 보여도 걱정 마세요. 차근차근 따라오시면 누구나 할 수 있습니다!

🤖 오픈클로(OpenClaw)가 뭔가요?

오픈클로는 사용자가 직접 호스팅하는 개인용 AI 에이전트입니다.
쉽게 말해, 내 컴퓨터에 AI의 '두뇌'를 설치하고 디스코드 같은 메신저를 통해 대화하고
명령을 내릴 수 있게 해주는 프로그램이죠. Claude, GPT 같은 강력한 AI 모델을 연결해
나만의 맞춤형 비서로 키울 수 있습니다.

✅ 필수 준비물 체크리스트

시작하기 전에 다음 준비물이 모두 갖춰졌는지 확인해주세요.

맥미니 M4: 기본형 모델로도 충분히 훌륭하게 작동합니다.
안정적인 인터넷: 24시간 서버로 활용하려면 유선 랜 연결을 권장합니다.
Docker Desktop: 오픈클로를 가장 쉽고 안정적으로 구동할 수 있는 환경입니다.
Docker 공식 홈페이지에서 'Apple Silicon' 버전을 다운로드하여 설치해주세요.
Anthropic Claude API 키: AI의 지능을 담당할 핵심입니다.
Anthropic 콘솔에서 계정을 만들고 API 키를 발급받아 안전한 곳에 복사해두세요. (유료 API입니다)
디스코드 계정: AI 비서와 소통할 창구입니다.

https://www.docker.com/products/docker-desktop/

Docker Desktop: The #1 Containerization Tool for Developers | Docker

Docker Desktop is collaborative containerization software for developers. Get started and download Docker Desktop today on Mac, Windows, or Linux.

www.docker.com

🚀 1단계: 맥미니 환경 설정 및 Docker 준비

가장 먼저 맥미니가 24시간 깨어있도록 설정해야 합니다.
'시스템 설정' -> '디스플레이' -> '고급...'에서 '디스플레이가 꺼져 있을 때 컴퓨터가 잠자지 않게 방지' 옵션을 켜주세요.
(또는 'Amphetamine' 같은 앱을 사용해도 좋습니다.)

Docker Desktop 설치가 끝났다면 실행해주세요.
상단 메뉴바에 고래 아이콘이 나타나면 준비 완료입니다.

🛠️ 2단계: 오픈클로 설치 (터미널 작업)

이제 맥의 '터미널(Terminal)' 앱을 열고, 개발자들의 언어로 대화할 시간입니다.
아래 명령어들을 한 줄씩 복사해서 붙여넣고 엔터(Return)를 눌러주세요.

1. 오픈클로 소스 코드 다운로드 (Git Clone)

Bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw

이 명령어로 오픈클로의 최신 소스 코드를 내 맥미니로 가져옵니다.

2. 설치 스크립트 실행 (Docker 방식)
오픈클로는 초보자를 위해 간편한 Docker 설치 스크립트를 제공합니다.

Bash

./docker-setup.sh

이 과정에서 필요한 이미지들을 다운로드하고 빌드하므로 시간이 조금 걸릴 수 있습니다. 차 한 잔의 여유를 가지세요! ☕️

⚙️ 3단계: 핵심 설정 (API 키 & 디스코드 연결)

설치가 완료되면 가장 중요한 설정 파일을 수정해야 합니다.
이 파일에 여러분의 API 키와 디스코드 봇 토큰을 입력하게 됩니다.

설정 파일 위치
설치 과정에서 생성된 설정 파일은 보통 ~/.openclaw/openclaw.json 또는
프로젝트 폴더 내 config 관련 디렉토리에 위치합니다. 터미널에서 안내하는 경로를 잘 확인해주세요.
디스코드 봇 만들기:
- 디스코드 개발자 포털에 접속하여 로그인합니다.
- 'New Application'을 클릭하고 적당한 이름을 지어줍니다 (예: My AI Assistant).
- 왼쪽 메뉴에서 'Bot'을 선택하고 'Add Bot'을 클릭합니다.
- 'Reset Token' 버튼을 눌러 봇 토큰을 생성하고 복사합니다. 이 토큰은 절대 남에게 보여주면 안 되는 비밀번호와 같습니다!
- 'Privileged Gateway Intents' 항목에서 'MESSAGE CONTENT INTENT'를 활성화해주세요. 그래야 봇이 여러분의 메시지를 읽을 수 있습니다.
- 왼쪽 메뉴 'OAuth2' -> 'URL Generator'에서 'bot' 체크박스를 선택하고, 필요한 권한(Send Messages, Read Messages/View Channel 등)을 체크한 후 생성된 URL로 봇을 여러분의 디스코드 서버에 초대합니다.

https://www.google.com/search?q=https://discord.com/developers/applications

🔎 https://discord.com/developers/applications: Google 검색

www.google.com

3. 설정 파일 수정
텍스트 편집기나 터미널 에디터(nano, vim 등)로 설정 파일을 엽니다.
아래와 같은 부분을 찾아 여러분의 정보로 채워주세요.

⚠️ 보안 주의: 외부에서 내 맥미니에 함부로 접속하지 못하도록, 설정 파일에서 포트 바인딩 주소를 0.0.0.0 대신
127.0.0.1(로컬호스트)로 설정하는 것이 안전합니다.

JSON

{
  "llm": {
    "provider": "anthropic",
    "apiKey": "여기에_여러분의_CLAUDE_API_키를_붙여넣으세요"
  },
  "channels": {
    "discord": {
      "enabled": true,
      "token": "여기에_방금_복사한_디스코드_봇_토큰을_붙여넣으세요"
    }
  }
  // ... 나머지 설정들
}

🎉 4단계: 오픈클로 실행 및 대화 시작!

모든 설정이 끝났습니다!
이제 터미널에서 오픈클로를 실행하는 명령어(보통 docker-compose up -d 또는 안내된 시작 스크립트)를 입력하세요.

잠시 후, 디스코드 서버에서 여러분이 초대한 봇이 온라인 상태로 바뀌는 것을 볼 수 있을 겁니다.
봇에게 "안녕, 반가워!"라고 말을 걸어보세요. 똑똑한 AI 비서가 여러분의 인사에 답해줄 것입니다.

마치며

이제 여러분의 맥미니 M4는 단순한 컴퓨터가 아니라, 24시간 여러분을 보조할 강력한 AI 서버로 다시 태어났습니다.
오픈클로를 통해 스케줄 관리, 정보 검색, 창의적인 글쓰기 등 다양한 작업을 AI 비서와 함께 해보세요.
여러분의 맥 라이프가 훨씬 더 스마트해질 것입니다!

설치과정에 위와 같이 에러가 난다면
명령어 앞에 Sudo를 붙이면 됩니다

저작자표시 비영리 변경금지 (새창열림)