맥에서 OpenClaw 쉽게 세팅하는 법

브라우저와 텔레그램까지 붙이는 가장 단순한 시작법

by 기웃

OpenClaw를 처음 보면 조금 복잡해 보인다.

기능이 많고 설정 항목도 제법 많아서 어디서부터 손대야 할지 막막할 수 있다.

그런데 실제로는 처음부터 모든 기능을 다 붙일 필요가 없다.

맥에서 가장 실용적으로 시작하려면 브라우저, 텔레그램, 그리고 기본 게이트웨이만 먼저 붙이면 된다.

이 세 가지만 되면 할 수 있는 일이 확 늘어난다.

브라우저 자동화가 가능해지고, 텔레그램으로 OpenClaw에게 말을 걸 수 있고, 작업 결과를 다시 텔레그램으로 보내게 만들 수도 있다.

처음 세팅은 이 정도만 목표로 잡는 것이 가장 덜 헷갈린다.

다만 여기서 꼭 먼저 말해야 할 중요한 전제가 하나 있다.

OpenClaw는 클라우드 AI 모델 계정이 반드시 필요하다.

예를 들어 Codex, OpenAI, GitHub Copilot 같은 모델 연결이 없으면 사실상 제대로 돌지 않는다.

로컬에 OpenClaw만 설치했다고 해서 혼자 완성되는 구조가 아니다.

OpenClaw는 껍데기와 운영 레이어에 가깝고, 실제로 사고하고 답하는 두뇌는 연결된 AI 모델이 맡는다.

그래서 이 부분이 준비되지 않으면 설치는 되어도 제대로 쓸 수 없다고 보는 편이 맞다.

처음 시작할 때 내가 추천하는 메인 경로는 openclaw configure다.

이 명령이 가장 무난하고, 처음 쓰는 사람도 덜 헷갈린다.

기본 설정을 직접 하나씩 잡아가기에 좋다.

반면 openclaw onboard는 옵션으로 생각하면 된다.

처음부터 설치 흐름을 단계별로 안내받고 싶다면, openclaw onboard를 실행해서 나오는 스텝을 따라가도 된다.

영어로 나오긴 하지만, 차분히 읽어보면 충분히 따라갈 수 있다.

설치 자체는 간단하다.

npm install -g openclaw

설치가 끝나면 버전과 도움말을 먼저 확인해보면 좋다.

openclaw --version

openclaw help

그다음은 기본 설정이다.

openclaw configure

조금 더 안내형으로 진행하고 싶다면 이렇게 해도 된다.

openclaw onboard

기본 설정이 끝나면 OpenClaw의 중심 역할을 하는 게이트웨이를 켜야 한다.

쉽게 말하면 OpenClaw의 심장 같은 것이다.

openclaw gateway start

상태 확인은 이렇게 하면 된다.

openclaw gateway status

openclaw status

이제 브라우저를 붙인다.

맥에서는 보통 Chrome을 OpenClaw 전용 프로필로 분리해서 쓰는 편이 안정적이다.

openclaw browser --browser-profile openclaw start

이렇게 하면 일반적으로 내가 평소 쓰는 브라우저와 OpenClaw 자동화용 브라우저를 나눠 쓸 수 있다.

상태는 아래처럼 확인한다.

openclaw browser status

여기서 running: true, cdpReady: true 같은 상태가 보이면 대체로 잘 붙은 것이다.

그다음은 텔레그램이다.

텔레그램은 직접 로그인하는 방식보다 봇 토큰을 넣는 방식으로 붙는 경우가 많다.

먼저 BotFather에서 봇을 만들고 토큰을 받아야 한다.

그다음 OpenClaw 설정에 넣는다.

openclaw config set channels.telegram.enabled true

openclaw config set channels.telegram.botToken "여기에_봇토큰"

openclaw plugins enable telegram

openclaw gateway restart

그 후 상태를 다시 확인한다.

openclaw status --deep

여기까지 오면 맥에서 OpenClaw를 가장 단순한 실사용 형태로 붙인 셈이다.

정리하면 순서는 이렇다.

1. OpenClaw 설치

2. openclaw configure로 기본 설정

3. 필요하면 openclaw onboard로 단계별 안내 따라가기

4. 클라우드 AI 모델 연결 확인

5. 게이트웨이 시작

6. 브라우저 전용 프로필 시작

7. 텔레그램 봇 토큰 연결

8. 상태 확인

처음부터 노드 연결, 원격 접속, MCP, 복수 채널까지 한 번에 붙이려 하면 오히려 꼬이기 쉽다.

OpenClaw는 기능이 많은 만큼, 가장 작은 성공 상태를 먼저 만드는 것이 중요하다.

맥에서는 브라우저와 텔레그램만 먼저 붙여도 충분히 쓸 만한 시작점이 된다.

그리고 다시 한 번 강조하면, Codex, Copilot, OpenAI 같은 클라우드 AI 모델 연결은 선택이 아니라 사실상 필수다.

이게 없으면 OpenClaw는 제대로 작동하지 않는다.

바로 이 점을 처음에 이해하고 시작해야 설치 후 허무하게 막히지 않는다.

명령어 모음

설치

npm install -g openclaw

openclaw --version

openclaw help

초기 설정

openclaw configure

openclaw onboard

게이트웨이

openclaw gateway status

openclaw gateway start

openclaw gateway restart

openclaw status

openclaw logs --follow

브라우저

openclaw browser status

openclaw browser --browser-profile openclaw start

텔레그램

openclaw config set channels.telegram.enabled true

openclaw config set channels.telegram.botToken "여기에_봇토큰"

openclaw plugins enable telegram

openclaw gateway restart

설정 파일 확인

cat ~/.openclaw/openclaw.json

작가의 이전글AI 시대, 폭포수 모델이 부활할까.