❓ 도움말 · 제05장

자주보기문제FAQ

遇까지문제먼저오여기찾기답변, 제품 포함기본、积분소비、장애정렬查등핵심문제。

5.1제품기본와버전선택择

1. EasyClaw에는 어떤 버전이 있나요? 어떻게 선택하나요?

버전대상 사용자특징官네트워크항목
중국 내 버전중국 내 사용자 첫 번째 선택마이크로정보/수동기기번호로그인, 지원Win/Maceasyclaw.cn
해외 버전해외 사용자Google 계정로그인, 지원Win/Maceasyclaw.com
클라우드 Bot24시간 온라인 필요브라우저로 접속, PC 클라이언트 설치 불필요해외 버전:cloudbot.easyclaw.com
중국 내 버전:cloudbot.easyclaw.cn
기업용 버전기업 팀지원권한관리、리소스소스共누리、协동일작업업企업国내클라우드 버전:work.easyclaw.cn
企업海외부클라우드 버전:easyclaw.work
企업国내桌화면버전:team.easyclaw.cn
企업海외부桌화면버전:team.easyclaw.com

2. 중국 내 버전과 해외 버전의 차이점은 무엇인가요? 공존할 수 있나요?

  • 모델型차이异: 중국 내 버전지원국내 주요 대형 모델(DeepSeek、千질문등);해외 버전지원海외부주流모델型(Claude/GPT/Gemini등)。
  • 불가공존: 하지 않能동일시간설치。설치목록기록동일, 설치제두 번째합니다直연결커버제하나。

아래에서 상세 비교를 확인하세요

비교 항목 EasyClaw(해외 버전) EasyClaw(중국 내 버전)
로그인 방식 Google 계정 중국 휴대폰 번호 / WeChat
네트워크 환경 VPN 필요 VPN 불필요 ✅
공식 웹사이트 easyclaw.com easyclaw.cn
지원모델型 해외 최상위 대형 모델
(GPT, Claude, Gemini등)
국내 주요 대형 모델
(DeepSeek, 千질문등)
핵심 기능 대체로 동일 대체로 동일
⚠️
버전 전환 경고

중국 내 버전에서 해외 버전으로 전환 시 설치된 Skills는 유지되지 않으며 다시 설치해야 합니다. 두 버전의 데이터는 호환되지 않습니다. 전환 전 중요한 설정과 memory 디렉터리를 백업하는 것이 좋습니다.

3. 桌화면버전입니다본로컬배포吗?과클라우드 버전있습니다何차이异?

입니다의, 桌화면버전위해본로컬배포。사용자파일、기록忆、설정설정全에서본로컬, 클라우드에 업로드되지 않아 데이터 보안성이 매우 높습니다.

차이异총结: 로컬 버전Agent실행에서전기컴퓨터에서, 能제어전기脑, 하지만关기기그것작동 중지;클라우드 버전실행에서云서비스도구上, 24작은시간대기命, 하지만불가제어본로컬의전기脑파일。

비교 표는 아래와 같습니다

비교 항목 桌화면버전(Easyclaw.com 에서线버전(Easyclaw.work
7×24 온라인 ❌ 컴퓨터 전원 켜짐 필요 ✅ 연중무휴
로컬 데스크톱 제어 ✅ 가능 ❌ 불가
데이터 개인정보 ✅ 완전 로컬 데이터가 클라우드에 있음
배포 난이도 설치 및 설정 필요 등록 후 바로 사용

4. 데스크톱 버전과 Bot 버전의 차이점은?

구분桌화면버전Bot버전(수동기기채널)
권한 능력최고 수준, 데스크톱 UI 및 브라우저 제어 가능24시간 온라인, 가벼운 원격 작업에 적합
온라인 상태컴퓨터 전원이 켜져 있어야 함7×24시간 응답
적용 시나리오복잡한 데스크톱 자동화, 로컬 파일 작업간단한 조회, 원격 작업 트리거
메모리 공유두 버전의 Memory는 서로 독립적입니다 (공유 파일에 기록하지 않는 한)

5.2사용문제와积분규칙则

1. 모델을 어떻게 전환하나요?

  • 桌화면버전: 대화대화창 오른쪽 하단 클릭클릭때이전모델型이름이름 → 선택择새모델型。
  • 클라우드 버전: 전송명령어 /model모델型이름(예 /model claude-sonnet-4.6)。

참고:하지 않동일채널의모델型설정설정하지 않互통신, Feishu、Telegram필요각각독립적설정설정。

2. 크레딧과 Token의 관계는?

  • 积분:EasyClaw의통신사용계획价단일位, 사용어떤모델型모두소비积분
  • Token:모델型서비스상품의계획양단일位。예果당신연결了자체고정义API Key, 则소비당신자신계정사용자의Token + EasyClaw의작업积분

3. 다양한 크레딧의 차이점은 무엇이며, 크레딧이 만료되나요?

  • ✅ 구매구매의积분누적하지 않清제로, 만필요续비용계속있습니다效, 당월 미사용분이 소멸되지 않습니다
  • ⚠️ 매매일 제공의 200积분때天까지기간, 未사용완료하지 않누적
积분유형 획득 방식 유효 기간 소비 순서
매일积분
(매일免비용积분)
매일 00:00에 자동으로 200 포인트까지 보충 때일있습니다效
(未사용완료归제로)
1 (최우선)
구독 크레딧
멤버십 유효 기간 동안 매월 자동 지급, 구독 날짜 기준 매월 갱신 3개월 2
구매 크레딧 멤버십 회원만 구매 가능 1년 3

4. 크레딧 소비가 너무 빠르면 어떻게 하나요?

다음과 같은 조치로 소비를 줄일 수 있습니다:

  • 즉시보기效: 전환换사용낮倍율모델型(예Qwen 3.5 Plus 0.6x);고정기간전송 /new 清공간대화기록史(생성议매10-20라운드실행실행一회);을/를복잡杂작업拆해결위해작은단계骤。
  • 장기省비용: 설정설정자체고정义API Key(대화을/를하지 않소비平플랫폼积분)。
  • 扩확장읽기: Token하락본三큰팁, 알림과도한 비용소비

5. 사용자 정의 API 사용 시에도 크레딧이 차감되나요?

대화유형요청요구: 0积분。
크레딧 차감분항목: browser-use(브라우저탐색도구제어)、computer-use(전기脑제어)、이미지像생성、음성전환쓰기등조정사용官방법하단层의서비스。

6. 크레딧을 환불하거나 이전할 수 있나요?

付비용후하지 않지원환불。단, V1.3.23이상버전지원에서 桌화면버전 ↔ 기업용 버전 간 크레딧 이전이 지원됩니다.

7. 자동 갱신 구독을 어떻게 취소하나요?

1

열기청구서 및 사용량

悬멈추오른쪽 상단의积분표시표시영역域, 点클릭弹출력菜단일에서의「청구서 및 사용량」

인터페이스 미리보기
2

관리 클릭

진입청구서 및 사용량페이지후, 찾기까지당신때이전의구독 플랜, 点클릭오른쪽의「관리」따라钮。

인터페이스 미리보기
3

플랜 변경 클릭

에서구독관리페이지에서, 点클릭「더플랜 변경」따라钮。

인터페이스 미리보기
4

다운그레이드 확인 클릭

선택择「확실히인식하락레벨」。取소비성공후, 여러분의구독을/를에서때이전계획비용周기간종료시간멈추갱신 중지비용。

인터페이스 미리보기
ℹ️
취소 후 어떻게 되나요?

• 여러분의구독을/를에서때이전계획비용周기간종료이전보장유지있습니다效, 계속누리받对해야의금액도과기능。
• 계획비용周기간종료후, 여러분의계정사용자자체동작하락레벨위해무료 플랜(매天 200 积분, 上제한 2,000)。
• 어떤이미구매구매하지만未사용의积분을/를영구보장留에서여러분의계정사용자에서, 따라시간가능사용。
• 예果후후회하면, 당신가능따라시간다시업그레이드레벨까지付비용플랜。

필요필요도움助?예果에서取소비구독통과프로세스에서遇까지어떤문제, 요청연락지원팀队:support@easyclaw.com

8. 멤버십 회원은 일반 사용자보다 어떤 혜택이 있나요?

  • 금액도:매월등금액의积분보충贴
  • 优먼저레벨:작업처리优먼저레벨더높음, 지원구매구매더다중积분
  • 성능价비교:추천「年도합니다직원」, 입니다최실제惠의선택择

5.3 설치 및 데이터 마이그레이션

1. Mac 설치 후 "열 수 없음" 메시지가 표시되나요?

해결결정办방법: 진입Mac의「시스템설정설정」 → 「개인정보 보호 및 보안성능」 → 「보안성능」 → 点클릭 "仍필요열기"。또는者따라住 Control 핵심 포인트클릭해야사용이미지标진행열기。
참고:M시스템시리즈 칩조각요청다운로드ARM버전, Intel芯조각요청다운로드Intel버전。

2. 컴퓨터 교체/시스템 재설치 시 데이터 마이그레이션은 어떻게 하나요?

1

추천방법案:云버전준비份 (V1.3.33+)

기존 컴퓨터: 메인 화면 → 프로필에 마우스 오버 → 클라우드 백업/복원 → 새 백업 만들기.
새 컴퓨터: 설치 및 로그인 → 클라우드 백업/복원 → 백업 복원.

2

이전 버전 수동 마이그레이션

workspace 폴더 아래의 SOUL.md, AGENTS.md, MEMORY.md 및 전체 memory/ 폴더를 새 컴퓨터의 해당 디렉터리로 수동 복사합니다.

중요 안내:채널설정설정필요다시설정설정, 积분과플랜불가수동동작마이그레이션。云버전준비份단지보장留60天, 합니다직원까지기간후데이터데이터합니다삭제。

5.4 핵심 기능 작업

1.어떻게설정설정Feishu / 그他원격채널?

点클릭경계화면왼쪽「휴대폰 원격」→ 선택择채널 → 扫코드또는따라제공표시연결。목록이전추천Feishu, 연결경험최완료정리。

2. 모델을 전환하거나 자체 API Key를 연결하는 방법은?

에서대화대화창 오른쪽 상단 클릭클릭「모델型전환换」即가능실시간전환换모델型。예필요연결자체고정义API, 点클릭「추가사용자 정의 모델」(필요1.3.24및이상버전)。

3. 가끔 실행이 매우 느린 이유는 무엇인가요?

1

프롬프트 확인

프롬프트가 완전하고 명확하게 표현되었는지 확인하여 Agent가 여러 번 확인하는 것을 방지하세요.

2

더 강력한 모델로 전환

복잡한 작업은 고급 모델로 전환해야 합니다. 기본 모델로 복잡한 작업을 처리하면 효율이 더 낮아지는 경우가 많습니다.

3

Agent에게 최적화 제안 요청하기

Agent에게 직접 물어볼 수 있습니다: 「이 워크플로우에서 더 최적화할 부분이 있나요? 개선 제안을 해 주세요.」

5.5Feishu채널와다중Agent아키텍처

1. 개인 Feishu 계정과 기업 계정 중 어떤 것으로 봇을 등록해야 하나요?

- 개인 계정: 봇을 생성할 수 있고 자신의 그룹에 추가할 수 있어 개인 사용에 충분합니다.
- 기업 계정: 권한 범위가 전체 기업 공간을 커버하며 다른 사람의 그룹에도 참여할 수 있습니다.
- 결론: 개인 사용, 자신이 그룹 생성 → 개인 계정으로 충분합니다.

2. Feishu에서 새 대화를 어떻게 시작하나요 (컨텍스트가 너무 길어 느려지는 것 방지)?

Agent에게 직접 "새 대화" 또는 "컨텍스트 재설정"이라고 말하세요. Agent 확인 후 다시 시작할 수 있습니다. 고급 사용자는 SOUL.md에서 자동 압축 규칙을 설정할 수도 있습니다 (10개 메시지마다 메모리 압축 실행).

3. 하나의 대화창 = 하나의 Agent인가요?

완전히 같지는 않습니다. Agent는 자신만의 페르소나, Memory, Skill 설정이 있는 AI 인스턴스입니다. 반면 대화창은 동일한 Agent와의 대화 기록(Session)입니다. 진정으로 다른 워크플로우를 원한다면 여러 Agent를 설정하고 각각 다른 Feishu 앱에 연결해야 합니다.

4. 멀티 Agent 아키텍처는 어떻게 작동하나요?

Multi-Agent 아키텍처에서는 하나의 주 Agent (Boss Agent)가 총괄 스케줄링을 담당합니다. Boss는 작업을 전문화된 Sub-Agent (서브 디지털 직원)에게 할당합니다. 서브 직원이 완료하면 주 Agent에게 보고하고, 최종적으로 주 Agent가 사용자에게 통합 응답합니다.

5. 주 Agent 스케줄링 후 결과가 Feishu 대화창에서 직접 생성되도록 할 수 있나요?

가능합니다. 단, 결과는 반드시 Boss Agent가 응답해야 하며 서브 Agent가 직접 응답할 수 없습니다.
프로세스: 여러분 → Boss Agent → sessions_spawn으로 서브 Agent 시작 → 서브 Agent 결과를 Boss에 반환 → Boss가 Feishu 대화창에서 응답

5.6시스템환경境문제

1. Mac 사용자는 어떤 버전을 다운로드해야 하나요?

  • Apple M시스템시리즈 칩조각(M1/M2/M3/M4)→ 다운로드 ARM버전
  • Intel芯조각 → 다운로드 Intel버전

확실하지 않은 경우: Apple 메뉴 → 이 Mac에 관하여, 「프로세서」 필드 확인.

2. 장시간 자동화 작업 실행 시 주의사항

  • 반드시 전원 연결을 유지하여 절전 모드 진입을 방지하세요 (장시간 작업 중 절전 모드 진입 시 중단됨).
  • 고성능 모드를 켜고 시스템의 「에너지 절약」 또는 「모니터링」 자동 종료 기능을 비활성화하세요.

3. 버전 업데이트는 어떤 내용에 영향을 미치나요?

마이너 버전 업데이트는 일반적으로 새로운 기능, 버그 수정, Skills 및 Memory 파일 최적화를 가져옵니다. 업데이트 후 MEMORY.md와 설치된 Skills가 정상적으로 작동하는지 확인하세요.

문제 발생 시 공식 지원팀에 문의: support@easyclaw.com

5.7 문제 해결 및 인보이스 발행

1. Feishu 봇이 응답하지 않으면 어떻게 하나요?

다음 단계에 따라 문제를 해결하세요:

  • 앱 내 테스트: EasyClaw 데스크톱에서 직접 메시지를 보내 응답하는지 확인하세요.
    응답하지 않으면 /status를 입력하여 크레딧 또는 Gateway 상태를 확인하세요.
    응답한다면 문제는 Feishu 연결에 있습니다
  • 연결 확인: 대화창에 「Feishu 연결 확인」을 입력하세요.
  • 일반적인 방해 요인: 컴퓨터가 절전/슬립 모드로 전환됨 (Mac은 Amphetamine 설치, Windows는 절전 모드 비활성화 권장); 또는 크레딧이 소진됨.

2. "LLM request timed out" 오류가 발생하면 어떻게 하나요?

이는 일반적으로 모델 서버 과부하, 컨텍스트가 너무 길거나 작업이 너무 복잡하기 때문입니다.
가장 효과적인 해결 방법: /new를 전송하여 대화 기록을 비우세요. 또는 저지연 모델(DeepSeek, Kimi, Qwen 등)로 전환하고 복잡한 작업을 작은 단계로 분해하여 전달하세요.

🧾
인보이스 발행은 어떻게 신청하나요?

중국 내 버전: 제품 내 오른쪽 상단 ≡ 클릭 → 크레딧 → 청구서 및 사용량 → 청구 내역 → 인보이스 발행. 또는 인보이스 발행 등록 양식을 작성하세요.
해외 버전: EasyClaw 인보이스 신청서를 작성하세요. 처리에 약 3영업일이 소요됩니다.