라벨이 OpenClaw인 게시물 표시

OpenClaw 설치 가이드 (1편) — 로컬에서 실행하는 나만의 AI 비서

이미지
OpenClaw란 무엇인가 OpenClaw는 자신의 서버(또는 PC)에서 직접 실행하는 자체 호스팅(Self-hosted) AI 게이트웨이 다. Telegram, WhatsApp, Discord, Slack, iMessage 등 다양한 메신저 플랫폼을 단일 허브로 연결하고, 각 채널로 들어오는 메시지를 AI 에이전트가 처리해 응답한다. 클라우드 기반 AI 서비스와 가장 큰 차이는 모든 데이터가 내 머신에서만 처리 된다는 점이다. API 키도, 대화 내용도, 에이전트의 메모리도 외부 서버로 전송되지 않는다. MIT 라이선스 오픈소스로 GitHub에 공개되어 있다. 어떤 일을 할 수 있나 OpenClaw 에이전트는 단순 Q&A를 넘어 실제 작업을 자율적으로 수행한다. 파일 시스템 읽기/쓰기 및 쉘 명령어 실행 Gmail, GitHub, Spotify, Obsidian 등 50개 이상 외부 서비스 연동 스케줄 기반 자동화 (크론 작업) 브라우저 제어 및 웹 스크래핑 대화 기반으로 에이전트 자체 스킬 작성·수정 지속적인 메모리 — 대화 내용을 기억하고 사용자 선호도를 학습 Telegram 봇을 통해 외출 중에도 서버에 명령을 보내고 결과를 받는 방식의 운용이 가능하다. 시스템 요구사항 설치 전에 아래 요건을 확인한다. 운영체제 : macOS, Linux, Windows (네이티브 또는 WSL2) Node.js : v24 권장, 최소 v22.16+ LTS — 인스톨러가 자동으로 처리하므로 미리 설치하지 않아도 됨 AI 모델 API 키 : Anthropic, OpenAI, Google 중 하나 이상 (온보딩 과정에서 입력) 네트워크 : 포트 18789가 로컬에서 열려 있어야 함 (기본값, 변경 가능) Windows 사용자의 경우 네이티브 설치도 지원하지만, WSL2 환경을 강력히 권장 한다. 안정성과 호환성이 훨씬 높다. 설치 방법 3가지 방법 1: 공식 인스톨러 스크립트 (권장) 가장 간단하고 권장되는 방법이다. 터미널 한 줄로 Node.js 설치부터 OpenC...

OpenClaw 설정 가이드 (2편) — Telegram 연동 + AI 모델 API 설정

이미지
설정 파일 위치와 형식 OpenClaw의 모든 설정은 ~/.openclaw/openclaw.json 파일 하나에서 관리한다. JSON5 형식을 사용하므로 주석( // )을 추가할 수 있다. 게이트웨이는 이 파일을 감시하다가 변경이 감지되면 재시작 없이 자동으로 설정을 반영 한다(Hot Reload). 설정 마법사를 사용하고 싶다면 아래 명령어로 대화형 설정을 진행할 수 있다. openclaw configure AI 모델 프로바이더 설정 OpenClaw는 Anthropic, OpenAI, Google 등 여러 AI 프로바이더를 지원한다. 사용할 모델은 provider/model-name 형식의 문자열로 지정한다. API 키 등록 온보딩 이후 API 키를 변경하거나 추가하려면 CLI 명령어를 사용한다. # Anthropic openclaw config set auth.profiles.anthropic.apiKey YOUR_ANTHROPIC_API_KEY # OpenAI openclaw config set auth.profiles.openai.apiKey YOUR_OPENAI_API_KEY API 키는 ~/.openclaw/credentials/ 디렉토리에 암호화되어 저장된다. openclaw.json 에 평문으로 작성하는 것도 가능하지만 보안상 CLI 방식을 권장한다. 모델 선택 openclaw.json 에서 기본 모델과 폴백 모델을 지정한다. { "agents": { "defaults": { "model": { "primary": "anthropic/claude-haiku-4-5-20251001", "fallbacks": ["openai/gpt-4o-mini"] } } } } 현재 설정된 모델 상태는 아래 명령어로 확인한다. openclaw models list...