OpenClaw 설치 가이드 (macOS / Mac mini M4)

대상

• macOS (Apple Silicon/arm64)

• zsh 기준

참고

• 설치/온보딩 과정에서 y 또는 yes 입력이 필요할 수 있습니다.

0) 사전 확인 (선택)

sw_vers
uname -m

• Apple Silicon이면 arm64가 출력됩니다.

1) OpenClaw 설치 (Node 직접 설치 없이: curl 방식)

설치 스크립트가 환경을 점검하고 필요한 의존성을 처리합니다.

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

1-1) 설치 확인

openclaw --version

1-2) (자주 발생) openclaw: command not found 해결

설치 위치가 ~/.local/bin 등에 잡혔는데 PATH가 반영되지 않은 경우가 있습니다.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
which openclaw

2) 온보딩 시작 (데몬 설치 권장)

백그라운드로 항상 실행되게 하려면 --install-daemon을 권장합니다.

openclaw onboard --install-daemon

• 원한다면 openclaw onboard만으로도 진행 가능합니다.

3) 위험성 안내(알럿) 확인

온보딩 중 아래 문구가 뜨면 Yes로 이동 후 Enter:

I understand this is powerful and inherently risky. Continue?
│  ○ Yes / ● No

4) 온보딩 모드 선택

일단 빠르게 붙이고 나중에 수정할 거면 QuickStart 추천:

Onboarding mode
│  ● QuickStart (Configure details later via openclaw configure.)
│  ○ Manual

5) 기존 설정값 처리

이미 설정이 있다면 Use existing values, 처음이면 Update values로 세팅:

Config handling
│  ● Use existing values
│  ○ Update values
│  ○ Reset

6) 모델/인증 제공자 선택: OpenAI (Codex OAuth)

ChatGPT(OAuth) 기반으로 연결하려면 OpenAI를 선택합니다. (API Key를 선택하면 OpenAI Platform API 과금 흐름이 될 수 있습니다.)

Model/auth provider
│  ● OpenAI (Codex OAuth + API key)
│  ○ Anthropic
│  ○ MiniMax
│  ○ Moonshot AI (Kimi K2.5)
│  ○ Google
│  ○ xAI (Grok)
│  ○ OpenRouter
│  ○ Qwen
│  ○ Z.AI (GLM 4.7)
│  ○ Qianfan
│  ○ Copilot
│  ○ Vercel AI Gateway
│  ○ OpenCode Zen
│  ○ Xiaomi
│  ○ Synthetic
│  ○ Venice AI
│  ○ Cloudflare AI Gateway
│  ○ Skip for now

7) OpenAI 인증 방식: Codex (ChatGPT OAuth)

아래에서 OpenAI Codex (ChatGPT OAuth) 선택:

◆  OpenAI auth method
│  ● OpenAI Codex (ChatGPT OAuth)
│  ○ OpenAI API key
│  ○ Back

선택하면 브라우저에서 ChatGPT 로그인/승인이 뜨고, 완료되면 다음 메시지가 보입니다:

Authentication successful. Return to your terminal to continue.

7-1) 기본 모델 선택

가장 최신/권장 모델(예: gpt-5.3-codex)을 선택합니다.

Default model
│  ● Keep current (openai-codex/gpt-5.3-codex)
│  ○ Enter model manually
│  ○ openai-codex/gpt-5.1
│  ○ openai-codex/gpt-5.1-codex-max
│  ○ openai-codex/gpt-5.1-codex-mini
│  ○ openai-codex/gpt-5.2
│  ○ openai-codex/gpt-5.2-codex
│  ○ openai-codex/gpt-5.3-codex

8) 채널 선택: Telegram

봇과의 소통 채널로 Telegram을 선택합니다.

Select channel (QuickStart)
│  ● Telegram (Bot API) (recommended · configured)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ○ Skip for now

8-1) Telegram 봇 토큰 만들기 (BotFather)

1. Telegram 앱 열기

2. @BotFather 검색

3. /start 실행

4. /newbot 선택

5. 봇 이름(name)과 유저네임(username) 설정

6. 발급된 Bot Token을 OpenClaw가 입력하라고 할 때 터미널에 붙여넣기

9) 스킬(Skills) 설정은 일단 Skip (선택)

처음엔 구동만 목표라면 No로 넘겨도 됩니다.

◆  Configure skills now? (recommended)
│  ○ Yes / ● No
└

10) Gateway 서비스(데몬) 처리

이미 설치되어 있다면 보통 Restart:

◆  Gateway service already installed
│  ● Restart
│  ○ Reinstall
│  ○ Skip

11) 관리 화면(TUI / Web UI) 선택

웹에서 관리하려면 Open the Web UI 선택을 추천합니다.

◆  How do you want to hatch your bot?
│  ○ Hatch in TUI (recommended)
│  ● Open the Web UI
│  ○ Do this later
└

기본 Web UI 주소(로컬):

http://127.0.0.1:18789/

12) Telegram 페어링(화이트리스트 승인)

OpenClaw는 기본적으로 승인된 사용자만 Telegram DM 가능합니다.

봇에게 DM을 보내면 아래 메시지가 발생합니다:

OpenClaw: access not configured.

Your Telegram user id: 7******

Pairing code: 2D*****

Ask the bot owner to approve with:
openclaw pairing approve telegram <code>

터미널에서 표시된 code로 승인:

openclaw pairing approve telegram 2D****

승인된 사용자 목록 확인:

openclaw pairing list telegram

13) 완료

이제 Telegram에서 봇에게 질문하면 OpenClaw가 응답합니다.

실행 상태 확인:

openclaw status

로그 확인(선택, 포그라운드 실행):

openclaw gateway --port 18789 --verbose