FAQ

빠르게 답을 찾고 막힘을 풀어 보세요.

보안 및 개인정보

API 키는 안전한가요?

API 키는 사용자 기기에만 저장됩니다(~/.openclaw/). 서버로 업로드되지 않습니다. 클라우드 모드에서도 로컬에 설정한 키는 동기화되지 않습니다. 보안 설정에서 키를 확인할 수 있습니다.

채팅 데이터는 어디에 저장되나요?

기본적으로 대화는 로컬에만 있습니다. 클라우드 계정에 로그인하면 기기 간 암호화 동기화를 사용할 수 있습니다. 클라우드 동기화는 선택 사항이며 끌 수 있습니다.

SPA가 개인정보를 수집하나요?

SPA는 추적을 위해 개인정보를 수집하지 않습니다. 앱은 로컬에서 실행됩니다. 클라우드 기능은 가입·로그인 시에만 활성화되며, 계정과 사용자가 동기화를 선택한 데이터에 필요한 것만 저장합니다.

클라우드 모드에서 누가 내 메시지를 볼 수 있나요?

클라우드 모드에서는 메시지가 AI 공급자(OpenAI, Anthropic 등)로 전달됩니다. 대화 내용을 저장하거나 읽지 않으며, 과금을 위한 사용량만 기록합니다. 더 엄격한 개인정보 보호가 필요하면 자체 API 키로 로컬 모드를 사용하세요.

SPA vs 기타 OpenClaw 구성

SPA는 OpenClaw와 어떤 관계인가요?

OpenClaw는 오픈소스 AI 에이전트 게이트웨이 엔진입니다. SPA는 이를 기반으로 하며, SPA를 설치하면 OpenClaw 엔진도 함께 설치되어 수동 의존성 설정이 필요 없습니다. 전체 GUI, 클라우드 로그인, 원클릭 설치, 자동 업데이트를 더합니다.

다른 호스팅 OpenClaw 「클라우드」 제품과 무엇이 다른가요?

많은 호스팅 구성은 팀용으로 게이트웨이를 서버에서 돌립니다. SPA는 게이트웨이를 사용자 컴퓨터에 두어 로컬 우선 데이터를 유지하고, CLI 없이 세련된 데스크톱 앱, 선택적 키 없는 사용·동기화를 위한 클라우드 계정, Node.js를 직접 설정하지 않는 원클릭 설치를 제공합니다.

SPA는 무료인가요?

SPA 데스크톱 앱은 무료로 다운로드해 사용할 수 있습니다. 로컬 모드에서는 AI 공급자에 API 사용료를 지불하고, 클라우드 모드에서는 클라우드 크레딧을 구매합니다. 모드는 언제든 전환할 수 있습니다.

사용 방법

언어와 테마는 어떻게 바꾸나요?

설정에서 UI 언어(중국어/영어)와 테마(라이트/다크/시스템)를 전환할 수 있습니다.

어떤 모델을 지원하나요?

SPA는 사실상 모든 OpenAI 호환 API를 지원합니다: OpenAI, Anthropic, DeepSeek, Gemini, Groq, Mistral, Qwen, Moonshot, SiliconFlow, OpenRouter 등. 공급자에 맞는 사용자 정의 Base URL을 사용하세요.

어시스턴트는 어떻게 만드나요?

AI 어시스턴트 → 만들기로 이동합니다. 이름을 정하고 모델을 고르고 시스템 프롬프트를 작성합니다. 여러 어시스턴트를 유지하고 채팅 중에 전환할 수 있습니다.

도구와 스킬은 어떻게 동작하나요?

어시스턴트 편집 → 도구: 내장 도구(파일, 검색, 코드 실행 등)를 켜고 마켓플레이스에서 스킬을 설치합니다. 어시스턴트는 필요할 때 활성화된 도구를 호출합니다.

Feishu 봇이 응답하지 않아요 — 무엇을 확인해야 하나요?

1) Feishu에서 최신 앱 버전을 게시했는지(가장 흔함). 2) 이벤트용 장기 연결 모드. 3) im.message.receive_v1 추가. 4) im:message 및 im:message:send_as_bot 권한. 5) SPA 실행 중이고 Gateway 연결됨.

환경

네트워크 오류로 설치에 실패해요

설치 과정에서 Node.js와 OpenClaw 엔진을 다운로드합니다. 네트워크가 불안정하면 앱이 자동으로 미러를 시도합니다. 설정 → 프록시에서 HTTP 프록시를 지정할 수도 있습니다.

Node.js를 직접 설치해야 하나요?

아니요. SPA는 자체 Node.js 런타임을 포함하며 시스템에 설치된 Node와 충돌하지 않습니다.

데이터 디렉터리는 어디인가요?

엔진·게이트웨이 데이터: ~/.openclaw/ (Windows: 사용자 폴더 아래 .openclaw). 앱 설정: macOS ~/Library/Application Support/spaclaw, Windows %APPDATA%\spaclaw. 앱 자체는 일반적인 Applications 위치에 설치됩니다.

문제 해결

막혔어요 — 「핵」 초기화는 무엇인가요?

SPA를 완전히 종료합니다(트레이 포함). ~/.openclaw/와 앱 지원 폴더를 삭제합니다(macOS: ~/Library/Application Support/spaclaw, Windows: %APPDATA%\spaclaw). 사이트에서 최신 빌드를 다시 설치합니다. 설정과 데이터가 모두 지워집니다.

Gateway가 항상 연결 끊김으로 표시돼요

포트 18789가 사용 중이 아닌지 확인하고, 설정에서 Gateway를 재시작하며, 디버그 페이지에서 로그를 읽으세요. 계속되면 위의 클린 재설치 단계를 시도하세요.

실행 시 흰 화면이에요

드문 경우입니다. 완전히 종료 후 다시 실행해 보세요. 반복되면 ~/.openclaw/와 spaclaw 앱 지원 폴더를 제거한 뒤 다시 시작하여 설정 마법사를 재실행하세요.

완전히 제거하려면 어떻게 하나요?

앱을 제거합니다(Windows: 앱, macOS: SPA.app을 휴지통으로). 그다음 ~/.openclaw/와 spaclaw Application Support 폴더를 삭제합니다. 데이터가 남지 않습니다.

macOS: OpenClaw를 초기화하고 설정 마법사 다시 실행

실행: rm -rf ~/.openclaw 및 rm -rf ~/Library/Application\ Support/spaclaw. 두 번째 줄은 「마법사 완료」 플래그를 지웁니다. SPA를 다시 열면 마법사로 들어갑니다. 앱도 제거하려면 /Applications/SPA.app을 삭제하세요.