OpenClaw는 사용자 자신의 기기에서 실행되는 개인 AI 어시스턴트입니다. 중앙 집중식 게이트웨이를 통해 메시징 서비스(WhatsApp, Telegram, Slack, Discord, iMessage 등)와 AI 코딩 에이전트를 연결합니다.

빠른 시작

ollama launch openclaw

Ollama가 모든 과정을 자동으로 처리합니다:

1. 설치 — OpenClaw가 설치되지 않은 경우 Ollama가 npm을 통해 설치하도록 안내합니다
2. 보안 — 최초 실행 시 도구 접근의 위험성을 설명하는 보안 공지가 표시됩니다
3. 모델 — 선택기에서 로컬 또는 클라우드 모델을 선택합니다
4. 온보딩 — Ollama가 제공자 설정, 게이트웨이 데몬 설치, 기본 모델 지정, OpenClaw 기본 제공 Ollama 웹 검색 활성화를 자동으로 처리합니다
5. 게이트웨이 — 백그라운드에서 실행되며 OpenClaw TUI가 열립니다

참고

OpenClaw는 넓은 컨텍스트 창이 필요합니다. 로컬 모델을 사용하는 경우 최소 64k 토큰 이상의 컨텍스트 창 사용을 권장합니다. 자세한 내용은 컨텍스트 길이를 참고하세요.

참고

이전에는 Clawdbot이라는 이름으로 알려져 있었습니다. ollama launch clawdbot 명령어가 여전히 별칭으로 작동합니다.

웹 검색 및 가져오기

OpenClaw에는 번들된 Ollama web_search 제공자가 포함되어 있어, 로컬 또는 클라우드 기반 Ollama 설정이 구성된 Ollama 호스트를 통해 웹 검색을 수행할 수 있습니다.

ollama launch openclaw

Ollama를 통해 OpenClaw를 실행할 때 Ollama 웹 검색이 자동으로 활성화됩니다. 수동으로 구성하려면:

openclaw configure --section web

참고

로컬 모델용 Ollama 웹 검색을 사용하려면 ollama signin이 필요합니다.

실행 없이 구성하기

게이트웨이와 TUI를 시작하지 않고 모델을 변경하려면:

ollama launch openclaw --config

특정 모델을 직접 사용하려면:

ollama launch openclaw --model kimi-k2.5:cloud

게이트웨이가 이미 실행 중인 경우 새 모델을 적용하기 위해 자동으로 재시작됩니다.

권장 모델

클라우드 모델:

• kimi-k2.5:cloud — 하위 에이전트를 활용한 멀티모달 추론
• qwen3.5:cloud — 비전 기능을 갖춘 추론, 코딩, 에이전트 도구 사용
• glm-5.1:cloud — 추론 및 코드 생성
• minimax-m2.7:cloud — 빠르고 효율적인 코딩 및 실제 업무 생산성

로컬 모델:

• gemma4 — 로컬에서 추론 및 코드 생성 (~16GB VRAM 필요)
• qwen3.5 — 로컬에서 추론, 코딩, 시각적 이해 (~11GB VRAM 필요)

더 많은 모델은 ollama.com/search에서 확인할 수 있습니다.

비대화형(헤드리스) 모드

Docker, CI/CD 또는 스크립트에서 상호작용 없이 OpenClaw를 실행하려면:

ollama launch openclaw --model kimi-k2.5:cloud --yes

--yes 플래그는 모델을 자동으로 풀링하고, 선택기를 건너뛰며, --model 지정이 필수입니다.

메시징 앱 연결

openclaw configure --section channels

WhatsApp, Telegram, Slack, Discord 또는 iMessage를 연결하면 어디서나 로컬 모델과 채팅할 수 있습니다.

게이트웨이 중지

openclaw gateway stop