오늘부터 차갑고 딱딱한 코드가 아니라, 24시간 내내 이용 가능한 개인 AI 인턴이 여러분을 도와드립니다!
글의 저자 및 출처: Draco (현재 VibeCoding 소속)
OpenClaw V3 초보자 가이드 🚀
✨ 시작하기 전에 한 가지 말씀드리겠습니다:
이 책은 보모 초보자를 위해 특별히 제작된 간결하고 명료한 안내서 입니다 .
초기 단계에서 이해할 필요가 없는 저수준 구성 및 배포 로직을 제거하여 가장 원활한 학습 곡선(최적의 학습 곡선)을 제공합니다.
전무상태에서 시작하여 -> API 획득 -> 성공적인 설치 -> Lark와의 통합 -> 데이터 유출 방지 -> 스킬 활용법 학습
준비됐나요? 안전벨트 매세요, 출발합니다!
파트 1: 미스터리 해부 (OpenClaw는 정확히 무엇일까요?)
🎯이 장의 목표 : 이 장을 마치면 OpenClaw가 무엇인지, 무엇을 할 수 있는지, 무엇을 할 수 없는지 친구들에게 명확하게 설명할 수 있게 됩니다.
⏱️예상 소요 시간 : 3분
이 장에서 배우게 될 내용
• OpenClaw가 무엇인지 친구에게 한 문장으로 설명해 보세요.
• 실제 사례 세 가지를 통해 이 기능이 어떤 도움을 줄 수 있는지 알아보세요
• 흔히 잘못 알려진 사실들을 바로잡고, 이 제품이 할 수 없는 일들을 알아두세요.
2026년에 갑자기 인기를 얻게 된 이유는 무엇일까요?
• 자신에게 가장 적합한 독서 경로를 선택하세요.
1.1 요약하자면, 당신의 AI 비서는 컴퓨터 안에 있습니다.
상상해 보세요. 당신은 매우 똑똑하고, 조사, 문서 작성, 데이터 정리 등을 능숙하게 처리하며, 24시간 언제든 도움을 줄 수 있는 인턴을 고용했습니다. 그런데 이 인턴에게는 사회보장세를 낼 필요도 없고, 퇴사 걱정도 할 필요가 없습니다.
OpenClaw는 마치 인턴과 같지만, 당신의 컴퓨터에 상주하는 프로그램입니다 .
더 정확하게 말하자면:
OpenClaw는 컴퓨터에서 AI 비서를 실행하고 Lark, Telegram과 같이 매일 사용하는 도구에 통합할 수 있도록 해주는 AI 에이전트 플랫폼 입니다.
먼저 몇 가지 핵심 개념을 살펴보겠습니다(이 개념들은 이후 장에서 자세히 다룰 것입니다).
• 에이전트: 마치 도구 상자를 가진 인턴처럼 자율적으로 작업을 수행할 수 있는 AI 프로그램입니다. "오늘 회의록을 정리하는 것을 도와줘"라고 말하면, 에이전트는 어떤 도구를 사용할지, 몇 단계를 거쳐 작업을 완료할지 스스로 결정합니다.
• 게이트웨이: 시스템의 중앙 제어실로, 메시지 라우팅 및 조정을 담당합니다. 기본 주소는 127.0.0.1:18789이며, 이는 컴퓨터에서 열려 있는 포트입니다.
• 채널: Lark, Telegram 등 다양한 채팅 플랫폼에 연결하는 인터페이스입니다.
• 도구: 에이전트가 실행할 수 있는 특정 기능으로, 파일 읽기 및 쓰기, 명령 실행, 웹 페이지 검색 등이 있습니다.
• 기술: 요원에게 어떤 도구를 언제 사용해야 하는지 알려주는 "사용 설명서".
당황하지 마세요. 지금은 이 단어들이 낯설게 느껴질 수 있지만, 몇 번 사용하다 보면 익숙해질 거예요.
1.2 활용 방법: 세 가지 실제 시나리오
개념에 대해 이야기하는 것은 너무 추상적이므로 실제 사례 세 가지를 살펴보겠습니다.
1.2.1 시나리오 1: 일일 보고서 자동 작성 (작업 클래스 저장)
샤오 왕은 퇴근 전에 그날 했던 일을 요약한 일일 보고서를 제출해야 한다. 예전에는 채팅 기록을 확인하고, 이메일을 확인하고, 그날 했던 일을 되짚어보는 데 최소 20분은 소비하곤 했다.
이제 그는 Lark에서 OpenClaw 로봇을 태그하고 있습니다.
"오늘의 일일 보고서를 작성하고, 프로젝트 포트폴리오에서 주요 진행 상황을 추출하고, 이메일에서 후속 조치 항목을 정리하는 것을 도와주세요."
로봇 자율성:
1. 지정된 그룹 채팅방의 오늘 메시지를 읽으세요.
2. 핵심 정보 추출
3. 지정된 형식에 따라 일일 보고서를 생성합니다.
4. 지정된 문서로 전송
20분을 절약한 덕분에 샤오 왕은 정시에 퇴근할 수 있었다.
1.2.2 시나리오 2: 연구 및 보고서 작성 (연구자에게 큰 이점)
샤오리는 산업 분석 보고서를 작성해야 하는데, 이를 위해서는 많은 데이터 수집이 필요하다. 예전에는 10개가 넘는 웹사이트를 오가며 손이 아플 때까지 복사 붙여넣기를 반복해야 했다.
이제 그는 OpenClaw에 이렇게 말합니다.
"2025년 AI 프로그래밍 도우미 시장 규모를 검색하고, 해당 데이터를 표로 정리하고, 데이터 출처를 포함하세요."
자동 에이전트:
1. 검색 도구를 사용하여 정보를 찾으세요.
2. 여러 웹 페이지에 접속하여 정보를 추출합니다.
3. 구조화된 표로 정리하세요
4. 데이터 소스에 레이블을 지정합니다.
육체노동에서 벗어난 샤오리는 분석과 판단에 집중할 수 있었다.
1.2.3 시나리오 3: Lark를 사용하여 작업에 @를 붙이기(강력한 팀 협업 도구)
팀 그룹에서 사람들이 자주 묻는 질문입니다:
• "지난달 판매 데이터 확인해 주실 분 계신가요?"
• 이 영어 문서를 번역해 주시면 감사하겠습니다.
• 이 PDF 파일을 마크다운으로 변환하세요
이제 그룹에서 봇을 멘션하세요:
"@Assistant님, 방금 보내주신 PDF 파일을 마크다운 형식으로 변환해 주세요."
로봇은 요청을 즉시 처리하고 결과를 그룹에 다시 보냅니다.
동료를 귀찮게 할 필요도 없고, 도구를 바꿀 필요도 없이 채팅으로 모든 작업을 처리할 수 있습니다.
1.3 무엇이 아닌가: 일반적인 오해 해소
OpenClaw는 강력한 도구이지만 만능 해결책은 아닙니다. 다음과 같은 오해들을 조속히 바로잡아야 합니다.
1.3.1 오해 1: ChatGPT를 대체하는 것이다
아니요.
ChatGPT는 웹페이지를 열기만 하면 간단하게 채팅할 수 있는 AI 대화형 제품입니다. OpenClaw는 사용자가 직접 AI 비서를 구축할 수 있는 플랫폼입니다.
이렇게 이해하시면 됩니다.
• ChatGPT = 숙련된 고객 서비스 담당자
• OpenClaw = 자체 고객 서비스 팀을 교육할 수 있는 시스템
실제로 OpenClaw는 ChatGPT의 API뿐만 아니라 Claude, KIMI, MiniMax와 같은 다른 모델들의 API에도 접근할 수 있습니다. OpenClaw는 모델들을 이용하는 업체이지, 경쟁 업체가 아닙니다.
1.3.2 오해 2: 클라우드 서비스이며 데이터는 다른 사람의 서버에 저장됩니다.
아니요 .
OpenClaw의 가장 큰 특징 중 하나는 바로 컴퓨터에서 실행된다는 점 입니다 .
• 채팅 기록은 로컬에 저장됩니다.
• 파일 처리는 로컬에서 수행됩니다.
• API 키는 제3자 서버를 거치지 않습니다.
이는 데이터 프라이버시에 관심 있는 기업과 개인에게 엄청난 이점입니다.
⚠️ 주의: OpenClaw는 로컬에서 실행되지만 AI 모델에 접근하려면 인터넷 연결이 필요합니다. 사용자의 메시지는 해당 AI 서비스 제공업체(예: OpenAI, KIMI 등)로 전송됩니다.
1.3.3 오해 3: 무작위로 온라인에서 물건을 구매하고 무작위로 이메일을 보낼 것이다.
습관.
OpenClaw는 최소 권한 원칙에 따라 설계되었습니다. 기본적으로 아무런 작업도 수행할 수 없습니다.
파일을 읽고 쓸 수 있도록 하려면 명시적으로 권한을 부여해야 합니다.
이메일을 보내고 싶으신가요? 이메일 도구를 설정해야 합니다.
• 명령어를 실행하게 하려면 샌드박스를 활성화하고 권한을 설정해야 합니다.
또한, 위험도가 높은 작업은 2차 확인 절차를 거쳐 "자체적으로 작동하지 않도록" 구성할 수 있습니다.
1.4 2026년에 갑자기 인기를 얻게 된 이유는 무엇일까요?
AI 에이전트라는 개념이 2026년에 갑자기 등장한 것은 아닌데, 왜 이제야 인기를 얻고 있는 걸까요?
1.4.1 이유 1: 대규모 모델의 기능이 "유용한" 임계값에 도달했습니다.
2024년 당시 GPT-4와 Claude 3는 이미 강력한 성능을 자랑했지만, 안정성은 부족했습니다. 2025~2026년에 출시된 모델들(Claude Opus 4.6/Sonnet 4.6, GPT-5.3-Codex, KIMI K2.5 등)은 복잡한 명령어를 이해하고 안정적인 출력 형식을 구현하는 데 있어 질적인 도약을 이루었습니다.
간단히 말해서, 이전의 AI 비서들은 종종 "인간의 말을 이해하지 못했지만", 현재의 AI 비서들은 가능합니다.
1.4.2 두 번째 이유: 엔지니어링 도구가 성숙해졌습니다.
뛰어난 두뇌만으로는 충분하지 않습니다. 다음 사항들도 필요합니다.
• 안정적인 메시지 송수신 메커니즘
• 신뢰할 수 있는 도구 호출 프레임워크
• 안전한 접근 제어 시스템
• 사용자 친화적인 설정 인터페이스
OpenClaw는 이러한 엔지니어링 과제를 해결하여 일반 사용자가 자신만의 AI 비서를 구축할 수 있도록 했습니다.
1.4.3 세 번째 이유: "장난감"에서 "도구"로의 전환
초창기 AI 에이전트는 괴짜들을 위한 장난감에 가까웠지만, 이제는 실제로 업무상의 문제를 해결할 수 있게 되었습니다.
• 일일 보고서를 정리하여 20분을 절약하세요
• 조사 및 보고서 작성 시간 2시간 절약
• 자동화된 데이터 처리로 반나절을 절약할 수 있습니다.
시간 절약 효과가 학습 비용을 초과하면 자연스럽게 광범위한 도입이 이루어질 것입니다.
1.5 독서 로드맵: 세 가지 유형의 독자를 위한 최단 경로
이 책은 17개의 장으로 구성되어 있지만, 전부 읽을 필요는 없습니다. 자신에게 가장 적합한 경로를 선택하세요.
1.5.1 경로 A: 빨리 시작하고 싶습니다 (모두 이 경로를 먼저 선택하는 것을 추천합니다)
목표: Lark에서 AI 로봇을 태그하고 로봇에게 특정 작업을 수행하도록 시켜보세요.
읽는 순서:
1. 제1장 (본 장) → 무엇인지 이해하기
2. 2장 → API 키 준비
3. 3장 → OpenClaw 설치
4. 5장 → Lark 접속하기
5. 6장 → 보안 정책 구성
예상 소요 시간 : 2~3시간
1.5.2 경로 B: 특정 작업을 수행하도록 심층적으로 사용자 정의하고 싶습니다.
목표: AI 비서가 데이터 분석 및 보고서 생성과 같은 특정 작업을 완료하도록 하는 것.
읽는 순서:
1. 먼저 A 경로를 완료하세요 (탄탄한 기초가 필수적입니다).
2. 10장 → 도구의 기능 이해하기
3. 11장 → 기존 기술 활용하기
4. 12장 → 첫 번째 스킬 글쓰기
5. 13장 → 고급 최적화
예상 소요 시간 : 1~2일
1.5.3 경로 C: 저는 기술 사용자이며 서버에 배포하려고 합니다.
목표: 서버에서 안정적으로 실행되고 팀원들과 공유할 수 있도록 하는 것.
읽는 순서:
1. 먼저 A 경로를 완료하세요 (기본 사항 이해).
2. 7장 → 모델 구성 최적화
3. 8장 → 설정 파일에 대한 심층 분석
4. 9장 → 보안 및 샌드박스
5. 15장 → 다중 작업 공간 구성
6. 제16장 → 배치 및 운영
예상 소요 시간 : 2~3일
이 섹션의 요약
복습해 봅시다:
1. OpenClaw란 무엇인가: 컴퓨터에서 AI 비서를 실행할 수 있게 해주는 AI 에이전트 플랫폼입니다.
2. 기능: 일일 보고서 작성, 보고서 조사 및 작성, 그리고 Lark(중국 인스턴트 메시징 플랫폼)에서 @를 사용하여 작업을 처리할 수 있습니다.
3. 할 수 없는 것: ChatGPT를 대체할 수 없으며, 순수한 클라우드 서비스도 아니고, 자체적으로 작동하지도 않습니다.
4. 현재 인기 있는 이유: 성숙한 대규모 모델링 기능 + 포괄적인 엔지니어링 도구 + 실제 문제를 해결하는 능력.
5. 시작하는 방법: 필요에 따라 A, B 또는 C 경로를 선택하세요.
직접 시도해 보세요
1. 이 장에서 나온 "공구 상자를 든 인턴" 비유를 사용하여 OpenClaw가 무엇인지 친구에게 설명하세요.
2. 생각해 보세요. 일상 업무에서 반복적인 작업 중 어떤 것들이 AI 비서에게 맡기기에 적합할까요?
3. 1.5절의 경로 지도를 참고하여 원하는 경로를 결정하십시오.
파트 2: 창업 준비 (이 세 가지만 있으면 됩니다)
🎯 이 장의 목표: 이 장을 완료하면 필요한 모든 조건을 충족하고 API 키를 준비했음을 확인할 수 있습니다.
⏱️ 예상 소요 시간: 10분
이 장에서 배우게 될 내용
• 컴퓨터가 운영 체제 요구 사항을 충족하는지 확인하십시오.
• API 키가 무엇이며 어떻게 얻는지 이해하십시오.
• 국내 3대 코딩 플랜(KIMI/MiniMax/GLM)의 상세 신청 절차
• 대안 솔루션 (OpenRouter/Anthropic)
• 최종 결과를 미리 보기
2.1 당황하지 마세요. 필요한 건 이 세 가지뿐입니다.
많은 기술 서적은 요구사항 목록을 나열하는 것으로 시작하여 독자들이 포기하게 만듭니다. 다른 접근 방식을 시도해 봅시다.
필요한 건 단 세 가지뿐입니다 .
1. 인터넷 접속이 가능한 컴퓨터 (Windows/Mac/Linux 모두 사용 가능)
2. API 키 (이 용어에 겁먹지 마세요. 그냥 비밀번호일 뿐입니다.)
3. 10분 (그리고 약간의 인내심)
그게 전부입니다. 프로그래머가 아니어도 되고, 인공지능을 이해할 필요도 없고, 서버를 구매할 필요도 없습니다.
2.2 첫 번째: 컴퓨터
2.2.1 시스템 요구 사항
간단히 말해서, 이 프로그램은 최근 5년 이내에 출시된 대부분의 컴퓨터에서 실행될 수 있습니다.
2.2.2 네트워크 요구 사항
다음 항목에 대한 접근 권한이 필요합니다:
• npm 레지스트리(OpenClaw 설치)
• 선택하신 AI 서비스 제공업체(예: KIMI, MiniMax 등)
중국 사용자 여러분께: OpenClaw 자체는 VPN을 필요로 하지 않지만, 일부 AI 서비스 제공업체는 VPN을 요구할 수 있습니다.
2.3 두 번째: API 키
2.3.1 API 키란 무엇인가요?
API 키(애플리케이션 프로그래밍 인터페이스 키)는 복잡해 보이지만, 사실은 여러 개의 비밀번호가 연결된 문자열일 뿐입니다.
비유를 들자면:
• 호텔 VIP 카드 → 서비스 이용 자격 증명
• 커뮤니티 출입 카드 → 출입 권한이 있음을 증명합니다.
• API 키 → AI 서비스에 접근할 권한이 있음을 증명합니다.
OpenClaw가 AI를 사용하여 작업을 수행할 때마다 이 키를 제시해야 합니다. AI 서비스 제공업체는 이 키를 사용하여 다음을 수행합니다.
1. 본인임을 확인하세요
2. 신용 한도 중 얼마를 사용했는지 계산하세요.
3. 귀하의 요청에 응답할지 여부를 결정하십시오.
2.3.2 국내 코딩 플랜 3가지 (권장)
중국 사용자분들께서는 다음 세 곳의 제공업체를 우선적으로 이용하시기를 권장합니다. 이들 모두 개발자를 위한 코딩 플랜을 제공하고 있으며, 본 장에서는 (국제 웹사이트를 제외하고) 중국 웹사이트의 용어를 일관되게 사용하겠습니다.
2.3.2.1 옵션 A: KIMI 코딩 계획(권장)
오후 5시 MQBY
신청 절차 :
1. https://www.kimi.com/code 를 방문하세요.
2. KIMI 계정에 로그인/회원가입하세요
3. "코딩 플랜 구독"을 클릭하세요.
4. 결제 완료 (알리페이/위챗페이 지원)
5. 콘솔에 접속하여 "API 키 생성"을 클릭합니다.
6. 생성된 키(sk-로 시작)를 복사합니다.
💡 주의: 키는 생성 후 한 번만 표시되므로 잘 보관해 주세요. 분실 시 다시 생성해야 합니다.
2.3.2.2 옵션 B: MiniMax 코딩 플랜(권장)
Cu5XmF
신청 절차 :
1. https://platform.minimaxi.com/subscribe/coding-plan 을 방문하세요.
2. 계정 등록/로그인
3. 실명 인증을 완료하십시오 (신분증 필요)
4. 코딩 플랜에 가입하세요
5. "API 관리" 페이지에 접속합니다.
6. API 키를 생성하고 복사하세요.
2.3.2.3 옵션 C: GLM 코딩 계획 (권장)
WUTpwh
신청 절차 :
1. https://bigmodel.cn/glm-coding 을 방문하세요.
2. Zhipu AI 계정에 가입/로그인하세요
3. 콘솔에 접속합니다.
4. "API 키" 메뉴를 클릭합니다.
5. 새 API 키를 생성합니다.
6. 복사하여 저장
2.3.3 세 회사 비교표
💡 참고: 위 가격은 국내 주요 3대 온라인 쇼핑몰의 결제 페이지에 표시된 가격을 기준으로 합니다. 프로모션 변동 사항은 실시간으로 해당 페이지를 확인해 주세요.
2.3.4 대안 솔루션
위의 세 회사 중 어느 곳도 적합하지 않다면 다음과 같은 선택지가 있습니다.
2.3.4.1 오픈라우터
특징: 하나의 API로 여러 모델(Claude, GPT, Llama 등)에 연결할 수 있습니다.
웹사이트: https://openrouter.ai
적합 대상: 하나의 키로 여러 모델에 접근하려는 사용자
참고: 중국 내에서 접속하는 경우 프록시 서버가 필요할 수 있습니다.
2.3.4.2 인류 (클로드 공식)
특징: Claude 모델용 공식 API, 최고 품질
웹사이트: https://console.anthropic.com
적합 대상: 최고 품질의 답변을 원하는 사용자
참고: 중국 내에서 접속하려면 프록시 서버가 필요하며 비용이 많이 듭니다.
2.4 세 번째: 10분
이 10분 동안 무엇을 할 건가요?
키를 저장하는 방법에 대한 제안:
1. 위챗/QQ 채팅 기록에 직접 저장하지 마세요.
2. 스크린샷을 사진 앨범에 저장하지 마세요.
3. 권장 보관 장소:
• 비밀번호 관리자(1Password, Bitwarden 등)
• 로컬 텍스트 파일(안전한 위치에 저장됨)
• 메모 (암호화가 지원되는 경우)
⚠️ 중요: API 키는 은행 카드 PIN 번호와 같습니다. 유출될 경우 누군가 당신의 돈을 사용할 수 있습니다. 안전하게 보관하세요!
2.5 무엇을 얻게 될지 미리 확인하세요
이 책을 다 읽고 나면 다음과 같은 결과를 얻게 될 것입니다.
Lark에서 @멘션할 수 있는 AI 로봇:
• 개인 메시지로 문의하세요
• 그룹 내에서 @It을 활용하여 일을 진행하세요
• 문서를 정리하고 정보를 검색하는 데 도움을 받으세요.
사용자 정의 가능한 AI 비서:
• 필요에 따라 스킬을 작성하세요
• 자주 사용하는 도구를 연결하세요
• 반복적인 작업 자동화
데이터 개인정보 보호에 대한 완벽한 제어:
• 모든 데이터는 로컬에 저장됩니다.
• 제3자 서버를 거치지 않고
기업 수준의 보안
이 섹션의 요약
자, 준비 체크리스트를 확인해 보세요.
• 인터넷 접속이 가능한 컴퓨터 (Windows/Mac/Linux)
• API 키 1개 (KIMI/MiniMax/GLM 중 하나를 선택하세요)
• 10분
모든 준비가 완료되었다면
직접 시도해 보세요
1. 컴퓨터 시스템 버전이 요구 사항을 충족하는지 확인하십시오.
2. 코딩 플랜을 선택하고 API 키 신청을 완료하세요.
3. 키를 안전한 곳에 보관하세요(비밀번호 관리 프로그램 사용을 권장합니다).
4. 네트워크 테스트: 선택한 AI 서비스 제공업체의 콘솔에 접속하여 정상적으로 열리는지 확인합니다.
제3부: 초고속 설치 (5분 만에 신화 속 괴물을 집으로 데려오세요)
🎯 이 장의 목표: 이 장을 마치면 OpenClaw를 설치하고 첫 번째 메시지를 보낼 수 있게 됩니다.
⏱️ 예상 소요 시간: 5분
📋 필수 조건: 2장(준비 작업)을 완료해야 합니다.
이 장에서 배우게 될 내용
• Node.js 환경을 확인하고 설치하세요
• 단 한 번의 명령으로 OpenClaw를 설치하세요
• 마법사를 실행하여 초기 구성을 완료하십시오.
• 퀵스타트와 수동 시작의 차이점을 이해하세요
• 국내 코딩 플랜 3개를 구성하세요
• 설치가 성공적으로 완료되었는지 확인하고 첫 번째 메시지를 전송하십시오.
3.1 환경 점검: Node.js란 무엇인가요?
3.1.1 Node.js 소개
Node.js는 컴퓨터에서 자바스크립트를 로컬로 실행할 수 있도록 해주는 환경입니다. 간단히 말하자면 다음과 같습니다.
Node.js는 JavaScript의 "번역기" 역할을 하여 브라우저 외부에서도 JavaScript가 작동할 수 있도록 합니다.
자세히 이해할 필요는 없고, 컴퓨터에 설치되어 있는지 확인하기만 하면 됩니다.
3.1.2 Node.js 버전 확인
터미널을 열고 다음을 입력하세요:
노드 --버전
예상 결과:
v22.xx
평가 기준:
• ✅ 버전 22 이상: 계속 진행 가능
• ❌ 버전
• ❌ "명령어를 찾을 수 없습니다" 메시지: 설치가 필요합니다.
3.1.3 Node.js가 요구 사항을 충족하지 못하는 경우
macOS 설치/업그레이드
# Homebrew를 사용하여 설치(권장) `brew install node` # 이미 설치되어 있지만 버전이 오래된 경우 업그레이드 `brew upgrade node`
윈도우 설치/업그레이드
권장 방법: 윙엣(winget)을 사용하세요.
winget install OpenJS.NodeJS.LTS
또는 수동으로 다운로드하세요.
1. https://nodejs.org 를 방문하세요.
2. LTS 버전(장기 지원 버전)을 다운로드하세요.
3. 마법사의 안내에 따라 설치하십시오.
💡 Windows 사용자 참고: 여러 가지 이상 현상을 방지하려면 OpenClaw를 WSL2에서 실행하는 것이 공식적으로 권장됩니다. WSL2 설치 가이드: https://docs.microsoft.com/zh-cn/windows/wsl/install
리눅스 설치/업그레이드
우분투/데비안:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs
CentOS/RHEL/Fedora:
sudo dnf install nodejs
3.1.4 설치 확인
설치 후 다시 확인하십시오.
노드 --버전 npm --버전
두 명령 모두 버전 번호를 반환해야 합니다.
⚠️ 자주 묻는 질문: 설치 후에도 "명령어를 찾을 수 없습니다"라는 메시지가 계속 표시되면 터미널을 다시 시작하거나 시스템에 다시 로그인해 보세요.
3.2 설치 명령어: 단 한 줄이니 복사해서 붙여넣으세요.
Node.js 버전이 22 이상인지 확인한 후 설치 명령을 실행하십시오.
npm install -g openclaw@latest
이 명령어는 무슨 일을 하는 건가요?
• npm: Node.js 패키지 관리자
• 설치: 설치
• -g: 전역 설치 (openclaw 명령어를 어느 디렉토리에서든 사용할 수 있습니다)
• openclaw@latest: npm에서 최신 릴리스를 설치하세요(이 책의 검증 동결 시점은 v2026.2.17입니다).
대기 시간: 네트워크 환경에 따라 다르며, 일반적으로 30초에서 2분 정도 소요됩니다.
3.2.1 설치 성공 여부 확인
openclaw --버전
다음과 유사한 결과가 나타날 것으로 예상됩니다.
2026년 2월 17일
❌ "명령어를 찾을 수 없습니다"라는 메시지가 표시되면
가능한 원인: npm의 전역 경로가 시스템 PATH에 추가되지 않았습니다.
해결책:
1. 터미널을 재시작하세요
2. 그래도 문제가 해결되지 않으면 전역 npm 경로를 확인하세요: `npm prefix -g`
3. 반환된 경로를 PATH 환경 변수에 추가합니다.
3.3 실행 마법사: OpenClaw 내장
설치 후 초기화 마법사를 실행하십시오.
OpenClaw 온보드 --install-daemon
매개변수 설명:
• 온보드: 초기화 마법사를 실행합니다.
• --install-daemon: 백그라운드 서비스도 설치합니다(권장).
3.3.1 마법사의 첫 번째 단계: 위험 식별 + 기존 구성 처리
마법사를 시작하면 일반적으로 다음과 같은 화면이 나타납니다.
? 이 기능은 강력하지만 본질적으로 위험하다는 것을 이해합니다. 계속하시겠습니까?❯ 예 아니오
계속하려면 '예'를 선택하세요.
이전에 OpenClaw를 설치한 경우 다음 내용도 표시됩니다.
기존 설정이 감지되었습니다...? 설정 처리❯ 기존 값 사용 값 업데이트 초기화
선택 방법:
• 첫 설치: 이 섹션은 일반적으로 표시되지 않으므로 다음 단계로 바로 진행하십시오.
• 재설치/모델 교체: 값 업데이트를 선택하십시오(권장, 다른 안정적인 구성은 유지).
• 완전히 처음부터 다시 시작하려면 재설정(주의)을 선택하십시오.
3.3.2 마법사의 2단계: 온보딩 모드 선택
가이드가 당신에게 다음과 같이 질문할 것입니다.
온보딩 모드❯ 빠른 시작 - 최소한의 설정으로 빠르게 실행 가능 수동 - 모든 설정을 완벽하게 제어 가능
어떻게 선택해야 할까요?
제안드리자면, 처음에는 빠른 시작을 선택하시고, 이후에는 언제든지 설정을 변경하실 수 있습니다.
3.3.3 마법사의 3단계: 먼저 모델 공급자를 선택합니다.
마법사가 모델 제공업체를 선택하라는 메시지를 표시합니다.
어떤 모델 제공업체를 사용하시겠습니까? OpenAI Anthropic❯ KIMI MiniMax GLM 기타 (사용자 지정 엔드포인트)
먼저 2장에서 신청한 제조업체(KIMI/MiniMax/GLM)를 선택하십시오.
3.3.4 마법사의 네 번째 단계: 인증 방법을 다시 선택하십시오 (인증 방법, 쉽게 간과될 수 있음)
벤더를 선택한 후에는 일반적으로 바로 키를 입력하라는 메시지가 나타나지 않습니다. 대신, 먼저 해당 벤더의 인증 방식을 선택하라는 메시지가 표시됩니다.
이런 모습을 자주 보게 될 겁니다:
? 인증 방식❯ 코딩 계획 / OAuth API 키
국내 독자분들은 코딩 플랜에 해당하는 옵션을 우선적으로 선택해 주시기 바랍니다.
• KIMI: Kimi 코드 API 키(구독) 경로 우선순위 지정
• MiniMax: MiniMax OAuth(CN) 경로의 우선순위를 높입니다.
• GLM (Z.AI): 선호하는 코딩 계획-CN 경로
3.3.5 마법사의 5단계: API 키를 입력하고 모델을 선택합니다.
KIMI를 선택하시면
KIMI API 키를 입력하세요: [키 붙여넣기] 모델을 선택하세요: ❯ kimi-k2.5
미니맥스를 선택하시면
MiniMax API 키를 입력하세요: [키 붙여넣기] 모델을 선택하세요: ❯ MiniMax-M2.5
GLM을 선택하시면
GLM API 키를 입력하세요: [키 붙여넣기] 모델을 선택하세요: ❯ glm-5
💡 참고: API 키를 붙여넣을 때 보안상의 이유로 터미널에 아무 문자도 표시되지 않습니다. 이는 정상적인 현상입니다. 붙여넣고 Enter 키를 누르세요.
3.3.6 마법사 6단계: 채널 구성 (먼저 건너뛰세요!)
빠른 시작 경로를 선택하면 마법사가 채널 선택 목록으로 바로 이동합니다.
? 채널 선택 (빠른 시작) ... 페이슈/라크 (페이슈) ...❯ 지금은 건너뛰기 (나중에 `openclaw channels add` 명령어를 통해 채널을 추가할 수 있습니다)
처음 사용하시는 분들은 "지금은 건너뛰기"를 선택하시는 것을 권장합니다.
왜 첫 번째 단계를 건너뛰나요?
이는 여러 차례의 실제 테스트를 통해 검증된 최적의 방법입니다.
1. 먼저 "TUI에서 안정적인 대화가 가능해야 함"이 제대로 작동하는지 확인하십시오.
2. 모델, 인증 및 게이트웨이가 모두 정상적으로 작동하는 것을 확인했습니다.
3. 채널에 재접속할 때 오류가 발생하면, 해당 오류가 "채널 설정 문제"인지 "기본 환경 문제"인지 명확하게 판단할 수 있습니다.
걱정하지 마세요. 5장에서 Lark 통합에 대해 자세히 설명하겠습니다.
3.3.7 마법사의 7단계: 스킬 구성(권장)
채널 선택 후, 마법사는 스킬 확인 및 선택적 설치 단계로 진행합니다.
스킬 상태: 적합: ...필요한 요건 미충족: ...? 지금 스킬을 구성하시겠습니까? (권장)❯ 예 아니오
가장 먼저 권장되는 사항은 '예'를 선택하는 것입니다. 이유는 간단합니다.
나중에 발생할 수 있는 문제를 방지하기 위해 자동으로 설치될 수 있는 종속성 패키지를 지금 설치하십시오.
다음에 자주 보게 될 내용은 다음과 같습니다.
? 누락된 스킬 종속성 설치❯ 지금은 건너뛰기 ? 스킬 설치에 선호하는 노드 관리자❯ npm pnpm bun
초보자를 위한 기본 조언:
1. 메인 스토리만 먼저 완료하고 싶다면, 지금 부분으로 바로 넘어가셔도 됩니다.
2. 스킬즈를 바로 플레이할 계획이라면 필요에 따라 설치 옵션을 선택하세요.
3. 로컬 머신에서 이미 사용 중인 노드 관리자를 선택하십시오(확실하지 않은 경우 npm을 사용하십시오).
3.3.8 마법사 8단계: 후크 구성 (최소 구성 권장)
스킬 설정 후에는 훅(Hooks) 설정으로 들어갑니다.
훅...? 훅을 활성화하시겠습니까?❯ 지금은 건너뛰세요
공식 문서에 따르면, 훅은 "특정 명령이 실행될 때 자동으로 작업을 수행"하는 데 사용됩니다(예: /new가 실행될 때 세션 메모리 정리 수행).
이 책에서 권장하는 최소한의 전략은 다음과 같습니다.
1. 처음에는 코어 후크를 하나만 활성화할 수 있습니다(최소한 사용 가능한 후크만 활성화하고, 세션 메모리 후크가 목록에 있으면 우선적으로 활성화합니다).
2. 만약 훅의 기능에 대해 아직 잘 모르시겠다면, 이 부분은 건너뛰셔도 됩니다.
3. 먼저 메인 스토리를 매끄럽게 진행한 다음, 10장에서 흥미를 유발하는 요소들을 체계적으로 관리하세요.
3.3.9 마법사의 9단계: 해치 방법(중요)을 선택합니다.
마지막 단계에서 마법사는 시작 지점 옵션을 제공합니다.
봇을 어떻게 부화시키시겠습니까?❯ TUI에서 부화 (권장) 웹 UI 열기 나중에 진행
선택 방법:
• TUI의 Hatch(권장): 터미널에서 바로 대화형 모드로 진입합니다(가장 안정적이며 기본값으로 권장).
• 웹 UI 열기: 브라우저 콘솔(그래픽)을 엽니다.
• 이 작업은 나중에 하세요: 먼저 가이드를 종료한 다음 나중에 다시 시작하세요.
TUI가 기본값으로 선택되는 이유는 무엇입니까?
1. 저희는 사용자가 로컬 컴퓨터에서 작업하고 있다고 가정할 수 없습니다. 많은 사용자가 클라우드 서버/VPS에서 실행하고 있습니다.
2. VPS를 사용하는 경우, 웹 UI를 열려면 포트 포워딩이 필요한 경우가 많은데, 이는 초보자에게는 사용하기 불편합니다.
3. TUI에서 Hatch를 선택하면 네트워크 또는 포트 문제로 인해 차단되지 않고 즉시 대화를 시작할 수 있습니다.
3.3.10 마법사 10단계: 대시보드 링크 및 게이트웨이 상태 기록
Hatch 선택을 완료하면 마법사에서 콘솔 액세스 정보와 게이트웨이 상태(예: 웹 UI, 게이트웨이 WS, 게이트웨이: 연결 가능)를 출력합니다.
"웹 UI 열기"를 선택하면 일반적으로 토큰이 포함된 대시보드 링크가 제공되며 브라우저가 자동으로 열립니다.
"나중에 진행"을 선택하신 경우, 다음 옵션이 제공됩니다.
오픈클로 대시보드 --no-open
콘솔 진입점을 다시 가져오세요.
3.4 초기 대화: 먼저 부트스트랩(실제 초기화)을 완료합니다.
온보딩 과정을 완료한 후에는 TUI에서 부트스트랩 대화의 첫 번째 단계를 완료하는 것이 좋습니다.
공식적인 절차에서는 이를 "에이전트를 사용자 에이전트로 전환"하는 핵심 작업으로 간주합니다(소스 코드에는 "일어나라, 친구여!" 가이드가 포함되어 있습니다).
이 단계에서는 다음 5가지 사항을 사전에 명확히 하는 것이 좋습니다.
1. 귀하에 대한 정보: 귀하를 어떻게 호칭해야 하는지, 귀하의 시간대 및 업무 언어를 알려주세요.
2. 어떤 역할을 맡기고 싶으신가요? 예를 들어, "기술 문서 작성 보조"와 같이 말입니다.
3. 평소 업무 환경: 자주 사용하는 도구, 파일 디렉토리, 소통 방식(Lark/이메일 등).
4. 선호하는 답변 형식, 길이, 결론을 먼저 제시할지 여부.
5. 작업 범위 설정: 어떤 작업은 먼저 확인해야 하고, 어떤 콘텐츠는 절대 건드려서는 안 되는지 명확히 하세요.
이 단계가 명확할수록 "일반적인 챗봇"보다는 "사용자 고유의 인스턴스"에 더 가까워질 것입니다.
💡 이 정보를 워크스페이스의 BOOTSTRAP.md / IDENTITY.md / USER.md / SOUL.md 파일에 저장하면 이후 세션을 더욱 안정적으로 진행할 수 있습니다.
Bootstrap 3.5를 사용한 후 첫 번째 "저문맥" 메시지를 보내세요.
초기 설정(부트스트랩)을 완료한 후에는 업무 경력과 관련 없는 간단한 테스트 메시지를 먼저 보내보는 것이 좋습니다.
먼저 이 방법을 사용해 보시길 추천합니다.
오늘 제가 할 수 있는 일 5가지를 우선순위 순으로 적어주세요 (각 일은 18자 이내여야 합니다).
"검색 기능"을 테스트하려면 다른 테스트를 추가할 수 있습니다.
오늘 베이징 날씨와 옷차림에 대한 조언을 한 문장으로 알려주세요.
전송하려면 Enter 키를 누르세요.
예상 응답:
모호한 자기소개를 계속하는 대신, (목록이나 날씨 추천과 같은) 구조화된 결과를 직접 제공해야 합니다.
답글이 보이면 설치가 완료된 것입니다! 축하합니다!
3.6 오류가 발생하면 어떻게 해야 할까요?
3.6.1 문제 1: 게이트웨이 시작 실패
증상: 마법사에서 게이트웨이가 시작되지 않았다고 표시됩니다.
가능한 이유:
1. 포트 18789가 사용 중입니다.
2. 권한 부족
3. 설정 파일 오류
해결책:
# 포트 사용량 확인: lsof -i :18789 # 또는 OpenClaw 게이트웨이를 다른 포트에서 시작: start --port 18790
3.6.2 문제 2: 보낸 메시지에 대한 답장이 없음
증상: 메시지를 보낸 후 "입력 중"이라고 계속 표시되지만 답장이 오지 않습니다.
가능한 이유:
1. API 키 오류
2. 네트워크 장애
3. 모델 서비스 오류
해결책:
# 설정 확인: openclaw config get # 모델 연결 확인: openclaw doctor # 로그 보기: openclaw logs
3.6.3 문제 3: 웹 UI를 열 수 없습니다
증상: 127.0.0.1:18789에 접속하면 브라우저에 "연결할 수 없습니다"라는 메시지가 표시됩니다.
가능한 이유:
1. 게이트웨이가 시작되지 않았습니다
2. 방화벽 차단
3. 잘못된 주소를 입력했습니다.
해결책:
# 게이트웨이가 실행 중인지 확인합니다. OpenClaw status # 실행 중이 아니면 수동으로 OpenClaw 게이트웨이 시작을 실행합니다.
이 섹션의 요약
오늘의 성과를 정리해 보겠습니다.
1. ✅ Node.js 환경 확인 완료 (>= v22)
2. ✅ OpenClaw가 설치되었습니다 (npm install -g openclaw@latest)
3. ✅ 초기화 마법사(openclaw onboard --install-daemon)가 실행되었습니다.
4. ✅ 국내 코드 플랜(KIMI/MiniMax/GLM)이 포함됩니다.
5. ✅ 최종 단계에서 TUI의 Hatch(추천)가 선택되었습니다(기본 추천).
6. ✅ 첫 번째 부트스트랩이 완료되었습니다(인스턴스를 "사용자 인스턴스"로 초기화).
7. ✅ 첫 번째 비즈니스 메시지가 전송되었습니다!
직접 시도해 보세요
1. TUI에서 대화를 이어가면서 업무 경계, 선호 사항 및 금지 구역에 대한 세부 정보를 추가하세요(부트스트랩 완료).
2. 실제 상황(예: 오늘 할 일 목록)을 바탕으로 실행 가능한 목록을 생성하도록 하세요.
3. 로컬 컴퓨터를 사용 중인 경우, 변경 사항을 확인하려면 대시보드/웹 UI를 다시 열어보세요.
4. 설치 중 문제가 발생하면 오류 메시지를 기록하고 4장에 따라 문제를 해결하십시오.
제4부: Lark 통합 (그룹에서 Lark와 대화하도록 설정)
🎯 챕터 목표: 이 챕터를 완료하면 Lark에서 AI 로봇을 태그하여 로봇에게 작업을 지시할 수 있게 됩니다.
⏱️ 예상 소요 시간: 30분
📋 필수 조건: 3장을 완료해야 합니다(TUI에서 Bootstrap 설치 및 첫 번째 대화 상자 완료).
이 장에서 배우게 될 내용
• Lark 오픈 플랫폼에서 엔터프라이즈 애플리케이션을 개발하세요
• 앱 ID와 앱 시크릿을 얻으세요
• 권한 설정 (JSON 일괄 가져오기 포함)
• "먼저 배포 → 나중에 구성 → 나중에 영구 연결 설정"이라는 핵심적인 시간 순서를 이해하십시오.
• OpenClaw 측에서 Lark 채널을 구성합니다.
• 페어링을 완료하고 송수신을 확인합니다.
5.1 3장에서 왜 먼저 채널을 건너뛰라고 했나요?
3장에서 나왔던 설정 마법사를 기억하시나요? 채널 단계에서 '건너뛰기'를 선택했었죠.
이는 누락이 아니라 의도적인 선택입니다.
실제 경험을 통해 우리는 다음과 같은 사실을 알게 되었습니다.
• 먼저, 모델, 인증 및 게이트웨이가 모두 올바르게 작동하는지 확인하기 위해 "TUI에서 안정적인 대화가 가능한지" 확인하십시오.
• 채널을 재통합할 때 발생하는 오류는 "채널 구성 문제" 또는 "기본 환경 문제"로 명확하게 구분할 수 있습니다.
이러한 "2단계" 접근 방식은 성공률이 더 높고 문제 해결도 더 쉽습니다.
3장을 이미 완료하고 TUI에서 부트스트랩 초기화를 마쳤다면, 이 장이 다음 단계입니다.
5.2 Lark 통합의 전반적인 과정
어떤 플랫폼을 사용하든 기본적으로 동일한 워크플로를 따릅니다.
1. 플랫폼 측에서 애플리케이션을 구축합니다(자격 증명 획득).
2. OpenClaw 측에서 채널을 구성합니다(openclaw channels add).
3. 게이트웨이를 시작하고 송수신 작업이 정상적으로 작동하는지 확인합니다.
4. 접근 권한에 대한 페어링/화이트리스트 설정
5. 그룹 채팅 전략, 멘션 전략 및 위험 관리 전략을 더욱 정교하게 다듬으세요.
이 5단계를 "프레임워크 수정"이라고 생각하시면 됩니다. 이 장에서는 우선 Lark를 작동시키는 방법을 설명합니다. 다른 채널에 대해서는 보충 장이나 공식 문서를 참조하십시오.
5.3 1단계: Lark 개인 채팅 봇 (복잡성 감소)
이 섹션은 두 부분으로 나뉩니다.
1. 첫 번째 단계: Lark 개인 챗봇은 안정적으로 메시지를 주고받을 수 있습니다.
2. 두 번째 단계: Lark 그룹 채팅에서 @봇에 답글을 달 수 있습니다.
왜 두 부분으로 나누는 거죠?
문제 해결 시 개인 채팅은 그룹 채팅보다 훨씬 간단합니다. 그룹 채팅을 설정하기 전에 개인 채팅이 제대로 작동하는지 확인하면 복잡성을 크게 줄일 수 있습니다.
5.4 1단계: Lark 오픈 플랫폼에 애플리케이션 생성
5.4.1 플랫폼을 열고 기업용 애플리케이션을 생성합니다.
1. Lark 오픈 플랫폼 열기: https://open.feishu.cn/app
2. Lark 계정에 로그인하세요(엔터프라이즈 관리자 권한 필요).
3. "엔터프라이즈용 자체 제작 애플리케이션 생성"을 클릭합니다.
엔터프라이즈 애플리케이션 생성
1. 신청 정보를 입력하세요:
• 애플리케이션 이름: "AI Assistant" 또는 "OpenClaw" 사용을 권장합니다.
• 애플리케이션 설명: 사내에서 사용하는 AI 비서
• 아이콘: 로봇 아이콘을 업로드할 수 있습니다.
5.4.2 앱 ID 및 앱 시크릿 획득
생성 후, 신청서 상세 정보 페이지로 이동하세요.
1. 왼쪽의 "바우처 및 기본 정보"를 클릭하세요.
2. 다음 정보를 기록하십시오.
• 앱 ID (형식: cli_xxxxxxxxxxxxxxxx)
• 앱 비밀 키 ("보기" 버튼을 클릭하면 확인할 수 있습니다)
자격 증명을 획득하세요
⚠️ 중요: 앱 비밀 정보를 철저히 비밀로 유지하세요. 스크린샷을 찍거나 그룹에서 공유하지 마세요. 유출될 경우 다른 사람이 봇을 조종할 수 있습니다.
5.4.3 권한 구성(일괄 가져오기)
이 단계는 오류가 발생하기 가장 쉬운 단계이므로 주의 깊게 따라하십시오.
1. 왼쪽에 있는 "권한 관리"를 클릭합니다.
2. "일괄 가져오기 권한"을 클릭합니다.
3. 다음 내용을 붙여넣으세요:
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "contact:user.employee_id:readonly", "corehr:file:download", "event:ip_list", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] }}1. "확인"을 클릭하세요
권한 설정
이러한 권한은 무엇을 위한 것인가요?
5.4.4 봇 기능 활성화
1. 왼쪽에 있는 "애플리케이션 기능"을 클릭합니다.
2. "로봇" 카드를 찾아 "활성화"를 클릭합니다.
3. 로봇 이름을 설정합니다(애플리케이션 이름과 일치하도록 설정하는 것이 좋습니다).
4. "저장"을 클릭하세요.
봇 기능 활성화
5.4.5 첫 번째 애플리케이션 릴리스 (⚠️ 중요 단계!)
중요: 이 단계는 영구 연결을 활성화하기 전에 반드시 완료해야 합니다!
실제 테스트 경험: 애플리케이션을 게시하기 전에 "장시간 연결 구독"을 활성화하면 일반적으로 지속적으로 오류가 발생합니다.
릴리스 단계:
1. 왼쪽에서 "버전 관리 및 릴리스"를 클릭합니다.
2. "버전 생성"을 클릭합니다.
3. 버전 정보를 입력하세요:
• 버전 번호: 1.0.0
• 업데이트 참고 사항: 초기 버전
4. "저장"을 클릭하세요.
5. "게재 신청"을 클릭하세요.
6. 회사 관리자의 승인을 기다리세요 (본인 회사인 경우 일반적으로 자동으로 승인됩니다).
💡 참고: 승인이 완료되면 신청 상태가 "게시됨"으로 변경됩니다. 그 후에야 다음 단계로 진행할 수 있습니다.
5.5 2단계: OpenClaw에서 Lark 구성
5.5.1 Lark 플러그인 활성화
먼저 플러그인 목록을 확인하세요.
오픈클로 플러그인 목록
페이슈가 존재하고 상태가 비활성화된 경우, 활성화하십시오.
OpenClaw 플러그인은 Feishu를 활성화합니다.
💡 참고: 공식 문서에서는 `openclaw plugins install @openclaw/feishu` 명령어를 사용하여 플러그인을 설치하는 것을 권장하지만, 이 책에서 수행한 실제 테스트 결과 내장 플러그인을 활성화하는 것이 더 안정적입니다.
5.5.2 채널을 대화형으로 추가하기
다음 명령어를 실행하세요:
오픈클로 채널 추가
안내에 따라 설정을 완료하세요.
질문 1: 채널 유형 선택
채널 유형을 선택하세요:❯ 페이슈/라크(Feishu) 텔레그램 웹챗 ...
비수/종달새(飞书)를 선택하세요
질문 2: 앱 ID를 입력하세요
Feishu 앱 ID를 입력하세요: cli_xxxxxxxxxxxxxxxx
버전 5.4.2에서 얻은 앱 ID를 붙여넣으세요.
질문 3: 앱 비밀번호를 입력하세요
Feishu 앱 비밀번호 입력: [비밀 붙여넣기]
버전 5.4.2에서 얻은 앱 시크릿을 붙여넣으세요(붙여넣을 때 문자가 표시되지 않는 것은 정상입니다).
질문 4: Lark 도메인 선택하기
어떤 Feishu 도메인을 사용하시나요? ❯ feishu.cn (국내 버전) larksuite.com (국제 버전)
국내 사용자는 feishu.cn을 선택할 수 있습니다.
질문 5: 그룹 채팅 전략
그룹 채팅 정책: ❯ 사용 안 함 (현재 그룹 채팅이 비활성화되어 있습니다) 사용 안 함
먼저 "사용 안 함"을 선택한 다음, 개인 채팅이 열리면 그룹 채팅을 시작하세요.
질문 6: 답글을 달려면 먼저 멘션을 받아야 하나요?
단체 채팅에서 멘션이 필요하신가요? ❯ 예 (답글을 달려면 단체 채팅에서 저를 멘션해야 합니다) 아니요
그룹에서 봇이 의미 없는 소리를 하는 것을 방지하려면 "예"를 선택하세요.
5.5.3 구성 확인
설정을 완료한 후 채널 목록을 확인하세요.
오픈클로 채널 목록
다음과 같이 표시되어야 합니다.
이름 유형 상태 feishu 구성됨
5.6 3단계: 이벤트 구독 활성화(장기 연결)
5.6.1 결정적인 타이밍 (⚠️ 피를 통해 얻은 교훈)
올바른 타이밍 순서는 다음과 같습니다.
1. ✅ Lark 측: 애플리케이션 생성 → 권한 구성 → 애플리케이션 게시
2. ✅ OpenClaw 측: "채널 추가" 옵션을 사용하여 채널을 구성하십시오.
3. ✅ OpenClaw 측: Launch Gateway 실행
4. ✅ Lark 측: 이벤트 구독 활성화(장시간 연결)
5. ✅ Lark 측: 이벤트 구독 주소 구성
순서가 잘못되면 장시간 연결이 실패하여 "메시지는 전송되었지만 로봇이 응답하지 않습니다"라는 메시지가 표시됩니다.
5.6.2 게이트웨이 시작
오픈클로 게이트웨이 시작
확인된 출력:
✓ 게이트웨이가 http://127.0.0.1:18789에서 시작되었습니다.
5.6.3 Lark 플랫폼에서 이벤트 구독 활성화
1. Lark 오픈 플랫폼으로 돌아가기
2. 왼쪽에 있는 "이벤트 및 콜백"을 클릭합니다.
3. "이벤트 구독 방식"에서 "영구 연결"을 선택합니다.
이벤트 구독을 구성합니다.
1. "저장"을 클릭하세요
5.6.4 이벤트 구독 추가
"이벤트 구독" 영역에서 "이벤트 추가"를 클릭하세요.
1. im.message.receive_v1을 검색하세요.
2. 확인란을 선택하고 추가를 확인하세요.
이 이벤트는 "메시지를 받으면 알려주세요"라는 의미입니다.
5.7 4단계: 매칭 및 릴리스
5.7.1 비공개 채팅 봇 트리거 매칭
라크에서:
1. 로봇 이름을 검색하세요
2. 개인 채팅 인터페이스에 접속합니다.
3. "안녕하세요"와 같은 메시지를 보내세요.
메시지가 먼저 "페어링"되어야 하므로 현재로서는 OpenClaw에 도달할 수 없습니다.
기본 dmPolicy: pairing 설정에서는 봇이 Lark 개인 채팅에서 페어링 코드가 포함된 페어링 프롬프트를 직접 표시합니다.
이는 사용자가 코드를 얻는 가장 직관적이고 쉬운 방법입니다.
5.7.2 방법 A (권장): 개인 채팅에서 페어링 코드를 사용하여 직접 승인합니다.
사용자들에게 Lark 개인 채팅에서 보이는 페어링 코드를 관리자에게 보내도록 요청하거나 직접 복사하세요.
그런 다음 터미널에서 다음 명령어를 실행하세요.
오픈클로 페어링 승인 페이슈예를 들어:
오픈클로 페어링 승인 feishu A1B2C3D4
(A1B2C3D4 부분을 Lark 개인 채팅에서 보이는 실제 페어링 코드로 바꾸세요)
5.7.3 방법 B (대안): OpenClaw에서 페어링 요청을 확인합니다.
개인 메시지에 코드가 보이지 않거나 다시 확인하고 싶다면 터미널에서 실행하세요.
오픈클로 페어링 리스트 페이슈
다음과 같이 표시되어야 합니다.
코드 ID 메타 요청됨 A1B2C3D4 ou_xxx... {...} 2026-02-18T10:10:00.000Z재승인:
오픈클로 페어링 승인 feishu A1B2C3D4
(A1B2C3D4를 이전 단계에서 확인한 실제 페어링 코드로 바꾸십시오.)
5.7.4 비공개 채팅 확인
라크로 돌아가서 메시지를 다시 보내세요.
안녕하세요, 자기소개 부탁드립니다.
예상 결과: 로봇이 메시지에 답장합니다!
5.8 5단계: 그룹 채팅 시작하기 (선택 사항)
개인 채팅이 설정되면 그룹 채팅 기능을 활성화할 수 있습니다.
5.8.1 채널 구성 수정
openclaw 채널 추가 --채널 feishu
개정하다:
• 그룹 채팅: 활성화됨
• requireMention: true
5.8.2 로봇을 그룹에 추가
1. Lark에서 그룹을 생성합니다.
2. "로봇 추가"를 클릭합니다.
3. 로봇 이름을 검색하세요
4. 그룹에 추가
5.8.3 그룹 채팅 @봇 테스트
그룹에 보내주세요:
@AI 어시스턴트, 안녕하세요
예상 결과: 로봇이 메시지에 답장합니다!
5.9 승인 체크리스트
이 장을 마치면 다음을 수행할 수 있어야 합니다.
• Lark 오픈 플랫폼에서 엔터프라이즈 애플리케이션을 생성하고 게시합니다.
• 앱 ID와 앱 시크릿을 얻으세요
• 권한을 구성하고 봇 기능을 활성화합니다.
• OpenClaw 측에서 Lark Channel을 구성합니다.
• 영구 구독 활성화
• 페어링 및 승인 완료
• 비공개 챗봇은 답변을 받을
