Clawdbot 설치 및 실행, 24시간 일하는 AI 비서 만들기. 초보자도 성공하는 5단계 완벽 로드맵

결론부터 말씀드리면, Clawdbot은 Claude API를 기반으로 24시간 내내 여러분을 대신해 작업을 수행하는 자가 호스팅 AI 어시스턴트입니다. 단순히 질문에 답하는 챗봇을 넘어, 여러분의 컴퓨터에서 직접 파일을 관리하고, 웹을 검색하며, 코드를 실행하고, 메신저를 통해 먼저 알림을 보내는 진짜 ‘비서’ 역할을 합니다.

혹시 ChatGPT나 Claude를 사용하면서 “이 작업을 자동으로 해줬으면 좋겠는데”라고 생각하신 적 있으신가요? 매번 브라우저를 열고, 질문을 입력하고, 결과를 복사해서 다른 곳에 붙여넣는 반복 작업이 귀찮으셨을 겁니다. 많은 분들이 AI 도구의 잠재력은 인정하지만, 실제 업무에 깊숙이 통합하기는 어렵다고 느끼시죠.

저도 처음 Clawdbot을 접했을 때는 “설치가 복잡하지 않을까?”, “기술적인 지식이 많이 필요하지 않을까?” 걱정했습니다. 하지만 공식 문서와 커뮤니티의 도움을 받아 직접 설치해본 결과, 단계별로 따라하면 약 30분 안에 충분히 구축할 수 있었습니다. 이제 그 경험을 바탕으로 초보자도 실패 없이 Clawdbot을 설치하고 실행할 수 있는 완벽한 로드맵을 공유합니다.

시스템 환경 준비 (Node.js v22 이상 필수)

Clawdbot은 Node.js 런타임 위에서 작동하므로, 가장 먼저 Node.js 버전 22 이상을 설치해야 합니다.

macOS 사용자는 터미널에서 “curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -” 명령어로 NodeSource를 통해 설치할 수 있으며, Windows 사용자는 반드시 WSL2(Windows Subsystem for Linux 2) Ubuntu 환경을 먼저 구축해야 합니다.

공식 문서에 따르면 macOS에서 앱까지 빌드하려면 Xcode 또는 Command Line Tools도 필요하지만, CLI와 Gateway만 사용할 경우 Node.js만으로 충분합니다.

설치 후 터미널에서 “node -v”를 입력해 버전이 22 이상인지 꼭 확인하세요. 이 단계에서 버전이 맞지 않으면 이후 모든 설치 과정이 실패할 수 있습니다.

Clawdbot Gateway 설치 및 실행

Node.js 설치가 완료되면 터미널에서 “npx @clawdbot/gateway install” 명령어를 실행합니다.

이 명령어는 Clawdbot의 Gateway 서버를 자동으로 설치하고 설정 파일을 생성합니다. Gateway는 여러분의 컴퓨터와 AI 모델, 그리고 메신저 채널을 연결하는 핵심 허브 역할을 합니다.

설치가 완료되면 “clawdbot gateway start” 명령어로 Gateway를 실행할 수 있으며, 기본적으로 localhost:3000 포트에서 작동합니다.

만약 “refusing to bind without auth” 오류가 발생한다면, “clawdbot doctor” 명령어를 실행해 자동 진단 및 수정을 받거나, “–force” 플래그를 추가해 강제 재설치할 수 있습니다.

API 키 설정 (Claude, OpenAI 등)

Clawdbot을 실제로 작동시키려면 AI 모델의 API 키가 필요합니다. Anthropic의 Claude API나 OpenAI의 GPT API 중 선택할 수 있습니다.

Anthropic Console(console.anthropic.com)에 접속해 API Keys 메뉴에서 새로운 키를 생성한 후, 터미널에서 “clawdbot config set anthropic.apiKey YOUR_KEY_HERE” 형식으로 입력합니다.

API 키는 민감한 정보이므로 절대 GitHub 등 공개 저장소에 업로드하지 마세요. 환경 변수 파일(.env)에 저장하거나 Clawdbot의 안전한 설정 관리 시스템을 사용합니다.

Community 커뮤니티에서는 Claude Opus 모델을 권장하고 있으며, 비용 절감을 원한다면 오픈소스 모델(Qwen3, Llama 등)을 로컬에서 Ollama로 실행하는 방법도 있습니다.

채널 연결 (텔레그램, 슬랙, 디스코드)

Clawdbot의 가장 큰 장점은 여러분이 평소 사용하는 메신저에서 직접 AI 비서와 대화할 수 있다는 점입니다.

텔레그램의 경우 BotFather를 통해 새로운 봇을 생성하고 발급받은 토큰을 “clawdbot channel add telegram –token YOUR_TOKEN” 명령어로 등록하면 됩니다.

슬랙은 Slack App 설정에서 Bot Token을 생성한 후 동일한 방식으로 추가하며, 디스코드는 Discord Developer Portal에서 Bot을 만들고 토큰을 연결합니다.

채널이 연결되면 메신저에서 봇에게 메시지를 보내는 것만으로도 Clawdbot이 작업을 수행하고, 필요하다면 먼저 알림을 보내 여러분의 주의를 환기시킵니다.

문제 해결 및 최적화 팁

공식 Troubleshooting 문서에 따르면 “Last gateway error” 메시지가 보인다면 “clawdbot doctor”를 실행해 자동 업데이트를 시도하거나, “–force” 옵션으로 Gateway를 완전히 재설치해야 합니다.

Reddit 커뮤니티에서는 초기 응답이 느리다고 느낄 때 Ollama에서 ‘thinking’ 과정을 표시하지 않아 발생하는 체감상의 문제일 수 있다고 지적했습니다.

보안을 강화하려면 “–dangerously-skip-permissions” 플래그 사용을 지양하고, 정식 권한 설정 절차를 밟는 것이 좋습니다. macOS 사용자라면 alias 기능을 활용해 자주 쓰는 명령어를 단축키로 등록하면 편리합니다.

메모리 부족 오류(Out of Memory)가 발생한다면 Node 프로세스의 메모리 할당량을 늘리거나, 더 가벼운 모델로 전환하는 것을 고려하세요.