OpenClaw(龍虾: Lobster) 입문: 기능, 설치, 설정, 사용법 및 그 의미

중국어권에서 「龍虾(롱샤)」라고 불리기도 하는 OpenClaw는 로컬 또는 자신이 관리하는 환경에서 구동하는 오픈 소스(Open Source) 퍼스널 AI 에이전트입니다.

일반적인 채팅 AI가 「질문에 답하는 것」에 집중하는 반면, OpenClaw는 메시지 앱, 브라우저, 파일, 외부 API, 스킬(Skill) 등을 연결하여 사용자를 대신해 여러 단계의 작업을 수행하는 것을 목표로 합니다.

이 기사에서는 OpenClaw의 기능, 설치, 기본 설정, 사용법, 그리고 왜 이러한 종류의 에이전트가 중요한지를 초보자 눈높이에 맞춰 정리합니다.

참고: 명령어 및 설정 항목은 2026-06-15 시점의 공식 문서(Official Documentation)를 바탕으로 합니다. 실제로 도입하기 전에 반드시 공식 README / Docs를 확인해 주세요.

OpenClaw는 자신의 디바이스나 서버에서 구동할 수 있는 AI 어시스턴트입니다. OpenAI, Anthropic, Google 등의 LLM 프로바이더(Provider)를 이용하며, Gateway라고 불리는 제어 평면(Control Plane)을 통해 채팅, 채널, 도구(Tool), 스킬을 통합적으로 다룹니다.

주요 특징은 다음과 같습니다.

로컬 퍼스트(Local-first) 방식의 Gateway
WhatsApp, Telegram, Slack, Discord, Signal, iMessage, LINE, WeChat 등 다수의 채널 연동
CLI, 대시보드, 메시지 앱을 통한 조작
스킬(Skill)을 통한 기능 확장
다중 에이전트, 다중 워크스페이스 운영
샌드박스(Sandbox) 및 DM 정책을 통한 안전 제어
음성, Canvas, 브라우저 조작, cron 등의 확장적인 도구 연동

요약하자면, OpenClaw는 「채팅 UI를 입구로 삼은, 자신만의 전용 자동화 에이전트 기반」입니다.

OpenClaw의 가치는 단순히 문장을 생성하는 것이 아니라, 외부 도구와 연결되어 작업을 진행할 수 있다는 점에 있습니다.

예를 들어, 다음과 같은 용도를 생각할 수 있습니다.

이메일 및 메시지 요약
태스크(Task) 정리
웹(Web) 조사
파일 조작
브라우저를 사용한 확인 작업
정기 실행 태스크
팀용 채널로의 알림
개인용 비서적 워크플로우(Workflow)
특정 업무용 커스텀 스킬 실행

일반적인 채팅 AI는 「대화」에서 그치기 쉽지만, OpenClaw는 「대화에서 행동으로」 나아가기 위한 메커니즘을 갖추고 있습니다.

OpenClaw의 구성을 심플하게 표현하면 다음과 같습니다.

중심이 되는 것은 Gateway입니다. Gateway가 채널, 설정, 세션, 도구, 스킬을 관리하며, 에이전트가 필요한 모델이나 도구를 호출합니다.

공식 문서에서는 Node.js 24를 권장합니다. Node.js 22.19 이상도 지원됩니다.

확인 명령어:

node --version

또한, LLM을 사용하기 위해 최소 1개의 모델 프로바이더 API 키 또는 그에 대응하는 인증 방법이 필요합니다.

예:

OpenAI
Anthropic
기타 OpenClaw가 지원하는 프로바이더

macOS / Linux에서는 공식 설치 스크립트를 사용하는 방법이 간편합니다.

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

Windows의 PowerShell에서는 다음과 같이 실행합니다.

iwr -useb https://openclaw.ai/install.ps1 | iex

npm으로 설치하는 경우 다음과 같이 합니다.

npm install -g openclaw@latest

또는 pnpm을 사용하는 경우:

pnpm add -g openclaw@latest

설치 후, 온보딩(Onboarding)을 실행합니다.

openclaw onboard --install-daemon

이 명령어는 Gateway, 워크스페이스, 모델 프로바이더, 채널, 스킬 등의 초기 설정을 대화 형식으로 진행해 줍니다. --install-daemon을 붙이면 Gateway를 백그라운드 서비스로 상주 시킬 수 있습니다.

Gateway의 상태를 확인합니다.

openclaw gateway status

정상적으로 작동하고 있다면 Gateway가 표준 포트 18789

대기 중임을 확인할 수 있습니다.

대시보드(Dashboard)를 열려면 다음 명령어를 사용합니다.

openclaw dashboard

브라우저에서 Control UI가 열리면 기본적인 설정이 완료된 것입니다.

OpenClaw의 설정 파일은 기본적으로 다음 위치에 있습니다.

~/.openclaw/openclaw.json

설정 파일이 존재하지 않더라도 안전한 기본 설정으로 동작합니다. 다만, 채널 연동, 모델, 도구, 샌드박스(Sandbox), 스킬(Skill) 제한 등을 조정하고 싶다면 이 파일을 편집합니다.

최소 구성의 이미지는 다음과 같습니다.

{
agents: {
defaults: {
...

설정은 CLI를 통해 확인하거나 변경할 수도 있습니다.

openclaw config get agents.defaults.workspace
openclaw config set agents.defaults.heartbeat.every "2h"

설정 오류가 있으면 Gateway가 시작되지 않을 수 있습니다. 그럴 경우 다음을 실행합니다.

openclaw doctor

복구 가능한 문제를 자동으로 수정하려면:

openclaw doctor --fix

모델은 provider/model 형식을 지정합니다.

예시:

{
agents: {
defaults: {
...

실제 운영 시에는 다음 관점에서 모델을 선택하는 것이 좋습니다.

응답 품질
도구(Tool) 사용의 안정성
비용
레이턴시 (Latency)
기업·개인 데이터를 다룰 때의 신뢰성
폴백 (Fallback) 필요 여부

OpenClaw는 다수의 채널을 지원합니다. 처음 시도한다면 Telegram이나 Discord가 비교적 이해하기 쉽습니다.

DM(Direct Message) 수신 방식은 dmPolicy로 제어합니다.

{
channels: {
telegram: {
...

대표적인 dmPolicy는 다음과 같습니다.

값	의미
`pairing`	알 수 없는 송신자에게 페어링 코드를 반환하고, 승인 후에 이용 가능하게 함
`allowlist`	`allowFrom`에 포함된 송신자만 허용
`open`	모든 DM을 허용
`disabled`	DM을 비활성화

처음에는 pairing 또는 allowlist를 사용하는 것이 안전합니다. open은 공개 봇에 가까운 동작을 하므로 신중하게 사용해야 합니다.

설정 후에는 Control UI의 채팅창이나 연동된 메시지 앱을 통해 OpenClaw에게 말을 걸 수 있습니다.

CLI에서 직접 메시지를 보낼 수도 있습니다.

openclaw agent --message "오늘의 작업 체크리스트를 만들어줘"

연결된 채널로 테스트 메시지를 보내는 예시:

openclaw message send --target +1234567890 --message "Hello from OpenClaw"

채팅 중 자주 사용하는 명령어에는 다음과 같은 것들이 있습니다.

명령어	용도
`/status`	현재 상태 확인
`/new`	새로운 대화 시작
`/reset`	세션 리셋
`/compact`	대화 이력 압축
`/think <level>`	추론 강도 조정
`/verbose on/off`	상세 로그 표시 전환

OpenClaw의 중요한 개념 중 하나가 스킬(Skills)입니다.

스킬은 에이전트에게 "어떤 상황에서, 어떤 도구를, 어떤 절차로 사용할지"를 가르치기 위한 확장 기능입니다. 많은 경우 SKILL.md라는 Markdown 파일에 설명이나 이용 조건을 작성합니다.

이미지로 표현하자면 AI에게 전달하는 "업무 매뉴얼"에 가깝습니다.

예를 들어 다음과 같은 스킬을 생각할 수 있습니다.

Gmail을 정리하는 스킬
GitHub Issue를 조사하는 스킬
사내 Wiki를 검색하는 스킬
청구서 PDF를 읽는 스킬
브라우저로 경쟁 사이트를 조사하는 스킬

Skill (기술)은 편리하지만, 외부 도구 및 파일 조작과 결합되기 때문에 신뢰할 수 없는 Skill (기술)을 부주의하게 추가하는 것은 위험합니다. 도입 전에 내용을 읽고, 권한을 확인하며, 필요하다면 샌드박스 (Sandbox)에서 실행하십시오.

OpenClaw는 강력합니다. 강력하다는 것은 설정을 잘못했을 때 리스크도 커진다는 것을 의미합니다.

특히 주의해야 할 점은 다음과 같습니다.

DM (다이렉트 메시지)을 누구나 보낼 수 있는 상태로 두지 말 것
API 키를 평문으로 공유하지 말 것
불분명한 Skill (기술)을 쉽게 추가하지 말 것
중요한 파일에 무제한으로 액세스하게 하지 말 것
팀 채널에서는 mention (멘션)을 필수화할 것
샌드박스 (Sandbox)를 활성화할 것
openclaw doctor 명령어로 정기적으로 진단할 것
게이트웨이 (Gateway)를 공개 네트워크에 노출하기 전에 공식 보안 가이드를 읽을 것

OpenClaw와 같은 에이전트 (Agent)는 이메일, 파일, 채팅, 브라우저 등에 접근할 수 있습니다. 즉, 기존의 챗봇 (Chatbot)보다 공격 표면 (Attack Surface)이 넓습니다. 편리함과 안전성은 함께 고려해야 합니다.

OpenClaw의 의미는 "AI를 단순한 답변 장치에서, 작업 환경 속에서 움직이는 에이전트 (Agent)로 가깝게 만드는 것"에 있습니다.

지금까지의 AI 이용은 사람이 매번 프롬프트 (Prompt)를 작성하고, 결과를 복사하여 다른 도구에 붙여넣는 형태가 많았습니다. 하지만 실제 업무는 여러 앱, 파일, 메시지, 판단, 확인 작업으로 구성되어 있습니다.

OpenClaw와 같은 에이전트 (Agent) 기반은 그 사이를 연결합니다.

채팅으로 요청하기
에이전트 (Agent)가 필요한 도구 선택하기
필요하다면 웹 (Web)이나 파일 확인하기
결과 정리하기
사용자에게 확인 요청하기
다음 액션으로 진행하기

이는 AI의 사용 방식이 "질의응답"에서 "업무 흐름 (Workflow)의 일부"로 변하는 것을 의미합니다.

OpenClaw는 다음과 같은 사람에게 적합합니다.

자신만의 AI 어시스턴트 (Assistant)를 만들고 싶은 사람
메시지 앱에서 AI를 사용하고 싶은 사람
로컬 퍼스트 (Local-first) 에이전트 (Agent) 기반을 시도해보고 싶은 사람
LLM (대규모 언어 모델)과 도구 연동 메커니즘을 배우고 싶은 사람
정형 작업을 자동화하고 싶은 개인 개발자
AI 에이전트 (Agent)의 안전 설계를 연구하고 싶은 사람

반면, 커맨드 라인 (Command Line)이나 설정 파일에 익숙하지 않은 사람이 갑자기 중요한 계정이나 운영 데이터를 연결하는 것은 권장하지 않습니다. 처음에는 작은 테스트용 환경에서 시도하는 것이 좋습니다.

OpenClaw(龍虾: Lobster)는 LLM (대규모 언어 모델), 메시지 채널, 도구, Skill (기술)을 연결하는 오픈 소스 개인용 AI 에이전트 (Agent) 기반입니다.

도입 흐름은 간단합니다.

Node.js 준비하기
OpenClaw 설치하기
openclaw onboard --install-daemon 실행하기
openclaw gateway status로 확인하기
openclaw dashboard로 Control UI 열기
모델, 채널, DM 정책, Skill (기술) 설정하기

OpenClaw는 AI를 "대화 상대"에서 "움직이는 파트너"로 가깝게 만드는 기술입니다. 다만, 외부 서비스나 파일 조작을 다루는 이상, 안전 설계는 필수입니다.

우선 작게 시작하여, DM 제어, Skill (기술) 확인, 샌드박스 (Sandbox), 진단 명령어를 사용하면서 조금씩 자신의 워크플로 (Workflow)에 편입시켜 나가는 것이 좋습니다.

OpenClaw(龍虾: Lobster) 입문: 기능, 설치, 설정, 사용법 및 그 의미

요약

핵심 포인트

댓글