튜토리얼
SPA Desktop 시작을 위한 단계별 안내 — 설치부터 Feishu 연동까지.
다운로드 및 설치
설치 프로그램 다운로드
다운로드 페이지에서 OS에 맞는 빌드를 선택하세요: Windows (.exe), macOS (.dmg), Linux (.AppImage).
설치 프로그램 실행
Windows: .exe를 더블 클릭하고 안내를 따르세요. macOS: .dmg를 열고 SPA를 응용 프로그램 폴더로 드래그하세요. Linux: AppImage를 우클릭 → 속성 → 실행 허용 후 더블 클릭하세요.
첫 실행 및 자동 설정
첫 실행 시 SPA가 Node.js 런타임, OpenClaw 엔진, 채널 플러그인을 설치하는 설정 마법사를 실행합니다. 보통 1~3분 걸립니다. 네트워크가 느리면 앱이 미러 서버를 자동으로 시도합니다.
AI 공급자 추가
설정 열기
왼쪽 사이드바에서 설정을 클릭하세요. AI 공급자 섹션에서 지원 공급자 목록을 확인할 수 있습니다.
공급자 활성화
원하는 공급자 카드(예: OpenAI, Anthropic, DeepSeek)를 열고 켠 뒤 API 키를 붙여넣으세요. 사용자 정의 엔드포인트(프록시, 자체 호스팅 모델)는 Base URL을 펼쳐 설정합니다.
채팅 시작
채팅으로 돌아가 드롭다운에서 모델을 고르고 대화를 시작하세요. 언제든 모델을 바꿀 수 있습니다.
클라우드 모드 사용
가입 및 로그인
사이드바에서 클라우드를 클릭하세요. 이메일 또는 서드파티 로그인으로 계정을 만든 뒤 로그인합니다.
클라우드 모드 켜기
로그인 후 클라우드 모드를 켭니다. API 키 없이 클라우드에서 이용 가능한 모델 목록으로 전환됩니다.
모델 선택 후 채팅
채팅을 열고 클라우드 모델을 선택해 대화하세요. 사용량은 클라우드 잔액에 청구됩니다. 잔액은 클라우드 페이지에서 확인할 수 있습니다.
Feishu 연결
앱 만들기
Feishu 개발자 콘솔(open.feishu.cn)을 열고 로그인한 뒤 맞춤 기업 앱을 만듭니다. 이름과 설명을 입력하세요.
봇 기능 추가
앱 페이지에서 기능 추가 → 봇을 선택합니다. 추가 후 왼쪽 메뉴에 봇이 표시됩니다.
이벤트 구독 설정
이벤트 및 콜백을 엽니다. 장기 연결(WebSocket)을 선택하면 공개 서버가 필요 없습니다. 이벤트 im.message.receive_v1을 추가하세요.
권한 및 게시
권한에서 im:message와 im:message:send_as_bot을 허용합니다. 그다음 버전 및 릴리스에서 버전을 만들어 게시합니다. 권한이나 이벤트를 바꿀 때마다 다시 게시해야 합니다!
SPA에서 설정
앱 자격 증명 페이지에서 App ID와 App Secret을 복사합니다. SPA → 채팅 플랫폼 → Feishu에 붙여넣고 저장합니다.
어시스턴트에 연결
AI 어시스턴트에서 Feishu에 쓸 어시스턴트를 편집합니다. 채널 연결에 feishu를 추가하고 저장합니다. Feishu 봇으로 오는 메시지는 해당 어시스턴트로 전달됩니다.