​

자주 묻는 질문

​

목차

• [빠른 시작 및 첫 실행 설정]
  • 문제에 직면했을 때 가장 빠르게 해결하는 방법은?
  • OpenClaw를 설치하고 설정하는 권장 방법은 무엇인가요?
  • 온보딩 후 대시보드를 어떻게 엽니까?
  • 로컬호스트와 원격에서 대시보드(토큰)를 어떻게 인증하나요?
  • 어떤 런타임이 필요합니까?
  • 라즈베리 Pi에서 실행됩니까?
  • 라즈베리 Pi 설치에 대한 팁이 있나요?
  • “Wake up my friend”에서 멈춰 있습니다 / 온보딩이 진행되지 않습니다. 이제 어떻게 해야 하나요?
  • 설정을 새로운 기기(Mac mini)로 이전할 수 있나요, 온보딩을 다시 하지 않고?
  • 최신 버전의 새로운 점을 어디에서 볼 수 있나요?
  • docs.openclaw.ai에 액세스할 수 없습니다 (SSL 오류). 이제 어떻게 하나요?
  • 안정 버전과 베타 버전의 차이는 무엇인가요?
  • 베타 버전을 어떻게 설치하며, 베타와 개발의 차이는 무엇인가요?
  • 최신 버전을 어떻게 시도하나요?
  • 설치와 온보딩은 보통 얼마나 걸리나요?
  • 설치 프로그램이 멈췄습니다. 어떻게 해야 더 많은 피드백을 받을 수 있습니까?
  • Windows에서 git을 찾을 수 없거나 OpenClaw가 인식되지 않는다는 메시지가 나옵니다.
  • 문서가 제 질문에 답하지 않았습니다 - 더 나은 답변을 얻으려면 어떻게 해야 하나요?
  • Linux에 OpenClaw를 어떻게 설치하나요?
  • VPS에 OpenClaw를 설치하는 방법은?
  • 클라우드/VPS 설치 가이드는 어디에 있나요?
  • OpenClaw에게 자체 업데이트를 요청할 수 있나요?
  • 온보딩 마법사는 실제로 무엇을 하나요?
  • 이것을 실행하려면 Claude 또는 OpenAI 구독이 필요합니까?
  • API 키 없이 Claude Max 구독을 사용할 수 있나요?
  • Anthropic “setup-token” 인증은 어떻게 작동하나요?
  • 어디에서 Anthropic setup-token을 찾을 수 있나요?
  • Claude 구독 인증(Claude Pro 또는 Max)을 지원합니까?
  • Anthropic에서 HTTP 429: rate_limit_error를 보는 이유는 무엇인가요?
  • AWS Bedrock이 지원됩니까?
  • Codex 인증은 어떻게 작동하나요?
  • OpenAI 구독 인증(Codex OAuth)을 지원합니까?
  • Gemini CLI OAuth을 어떻게 설정하나요?
  • 일반 채팅에 로컬 모델을 사용해도 괜찮나요?
  • 호스팅된 모델 트래픽을 특정 지역에 유지하려면 어떻게 해야 하나요?
  • 이것을 설치하려면 Mac Mini를 구매해야 하나요?
  • iMessage 지원을 위해 Mac mini가 필요합니까?
  • OpenClaw를 실행하기 위해 Mac mini를 구입한 경우, MacBook Pro에 연결할 수 있나요?
  • Bun을 사용할 수 있나요?
  • Telegram: allowFrom에 무엇을 입력해야 하나요?
  • 여러 OpenClaw 인스턴스와 하나의 WhatsApp 번호를 여러 사람이 사용할 수 있나요?
  • “빠른 채팅” 에이전트와 “Opus for coding” 에이전트를 실행할 수 있나요?
  • Homebrew가 Linux에서 작동하나요?
  • 해킹 가능한(git) 설치와 npm 설치의 차이점은 무엇인가요?
  • 나중에 npm과 git 설치 간 전환할 수 있나요?
  • 게이트웨이를 노트북 또는 VPS에 실행해야 하나요?
  • 전용 머신에서 OpenClaw를 실행하는 것이 얼마나 중요한가요?
  • 최소 VPS 요구 사항과 권장 OS는 무엇인가요?
  • OpenClaw를 VM에서 실행할 수 있으며 요구 사항은 무엇인가요?
• OpenClaw란 무엇인가요?
  • 한 문장으로 OpenClaw란 무엇인가요?
  • 가치 제안은 무엇인가요?
  • 설정을 완료했습니다. 무엇을 먼저 해야 하나요?
  • OpenClaw의 일상적인 사용 사례 상위 5가지는 무엇인가요?
  • OpenClaw가 SaaS의 리드 생성 외연 광고 및 블로그에 도움이 될 수 있나요?
  • 웹 개발에 있어서 Claude Code보다 어떤 장점이 있나요?
• 스킬과 자동화
  • 저장소를 더럽히지 않고 스킬을 어떻게 커스터마이즈하나요?
  • 사용자 지정 폴더에서 스킬을 로드할 수 있나요?
  • 다른 작업에 다른 모델을 어떻게 사용할 수 있나요?
  • 봇이 무거운 작업을 수행할 때 멈춥니다. 이를 어떻게 해소하나요?
  • Cron 또는 리마인더가 실행되지 않습니다. 무엇을 확인해야 하나요?
  • Linux에 스킬을 어떻게 설치하나요?
  • OpenClaw가 일정에 따라 또는 백그라운드에서 계속해서 작업을 수행할 수 있나요?
  • Linux에서 macOS 전용 스킬을 실행할 수 있나요?
  • Notion 또는 HeyGen 통합이 있나요?
  • 브라우저 사용 권한을 장악하기 위해 Chrome 확장을 어떻게 설치하나요?
• 샌드박스 격리와 메모리
  • 전용 샌드박스 문서가 있나요?
  • 호스트 폴더를 샌드박스에 어떻게 바인딩하나요?
  • 메모리는 어떻게 작동합니까?
  • 메모리가 계속 잊어버립니다. 어떻게 유지시키나요?
  • 메모리는 영원히 지속되나요? 제한이 있나요?
  • 의미적 메모리 검색에는 OpenAI API 키가 필요합니까?
• 파일 저장 위치
  • OpenClaw에서 사용되는 모든 데이터가 로컬에 저장되나요?
  • OpenClaw가 데이터를 어디에 저장하나요?
  • AGENTS.md / SOUL.md / USER.md / MEMORY.md는 어디에 있어야 하나요?
  • 권장하는 백업 전략은 무엇인가요?
  • OpenClaw를 완전히 제거하려면 어떻게 하나요?
  • 에이전트가 작업 공간 외부에서 작동할 수 있나요?
  • 원격 모드입니다. 세션 저장소는 어디 있나요?
• 설정 기본
  • 설정의 형식은 무엇이며, 어디에 있나요?
  • gateway.bind: "lan"(또는 "tailnet")을 설정했더니 아무것도 수신하지 않거나 UI가 승인되지 않았다고 합니다.
  • 왜 이제 로컬호스트에서 토큰이 필요할까요?
  • 설정을 변경한 후 다시 시작해야 하나요?
  • 웹 검색(및 웹 가져오기)을 어떻게 활성화합니까?
  • config.apply가 내 설정을 지웠습니다. 어떻게 복구하고 이를 피할 수 있을까요?
  • 특수 작업자를 여러 디바이스에 걸쳐 중앙 게이트웨이로 어떻게 실행하나요?
  • OpenClaw 브라우저를 헤드리스로 실행할 수 있나요?
  • 브라우저 제어에 Brave를 어떻게 사용합니까?
• 원격 게이트웨이 및 노드
  • Telegram, 게이트웨이, 노드 간의 명령이 어떻게 전파됩니까?
  • 게이트웨이가 원격으로 호스팅되는 경우, 내 에이전트가 내 컴퓨터에 어떻게 액세스할 수 있을까요?
  • Tailscale이 연결되었지만 응답이 없습니다. 이제 어떻게 해야 하나요?
  • 두 개의 OpenClaw 인스턴스(로컬 + VPS)가 서로 대화할 수 있나요?
  • 여러 에이전트를 위해 별도의 VPS가 필요합니까?
  • VPS에서 SSH를 사용할 때 노드를 사용하는 대신 개인 노트북에 노드를 사용하는 이점이 있나요?
  • 노드가 게이트웨이 서비스를 실행합니까?
  • 설정을 적용하는 API/RPC 방법이 있나요?
  • 첫 설치를 위한 최소 “무결성” 설정은 무엇인가요?
  • VPS에서 Tailscale을 어떻게 설정하고 내 Mac에서 연결합니까?
  • Mac 노드를 원격 게이트웨이에 어떻게 연결합니까 (Tailscale Serve)?
  • 두 번째 노트북에 설치해야 하나요, 아니면 노드를 추가하는 것이 좋나요?
• 환경 변수 및 .env 로딩
  • OpenClaw가 환경 변수를 어떻게 로드합니까?
  • “서비스를 통해 게이트웨이를 시작했는데 환경 변수가 사라졌습니다.” 이제 어떻게 해야 하나요?
  • COPILOT_GITHUB_TOKEN을 설정했지만 모델 상태는 “Shell env: off.”라고 표시됩니다. 왜 이런가요?
• 세션 및 다중 채팅
  • 새로운 대화를 어떻게 시작하나요?
  • /new를 보낸 적이 없으면 세션이 자동으로 재설정됩니까?
  • OpenClaw 인스턴스를 한 CEO와 여러 에이전트로 구성된 팀으로 만들 수 있나요?
  • 작업 중간에 컨텍스트가 잘려나간 이유는 무엇이며, 이를 어떻게 방지할 수 있나요?
  • OpenClaw를 완전히 재설정하고 설치된 상태를 유지하려면 어떻게 해야 합니까?
  • “컨텍스트가 너무 큽니다” 오류가 발생했습니다 - 어떻게 리셋하거나 컴팩트하게 만들까요?
  • “LLM 요청 거부됨: messages.N.content.X.tool_use.input: 필드 필요”를 보는 이유는 무엇인가요?
  • 30분마다 왜 하트비트 메시지가 나타납니까?
  • WhatsApp 그룹에 “봇 계정”을 추가해야 하나요?
  • WhatsApp 그룹의 JID를 어떻게 얻나요?
  • 왜 OpenClaw는 그룹에서 답장하지 않나요?
  • 그룹/스레드가 다이렉트 메시지와 컨텍스트를 공유합니까?
  • 얼마나 많은 워크스페이스와 에이전트를 만들 수 있습니까?
  • 여러 봇 또는 채팅을 동시에 실행할 수 있나요(Slack) 그리고 어떻게 설정해야 하나요?
• 모델: 기본값, 선택, 별칭, 전환
  • “기본 모델”이란 무엇인가요?
  • 추천하는 모델은 무엇인가요?
  • 설정을 지우지 않고 모델을 어떻게 전환하나요?
  • 자체 호스팅 모델(llama.cpp, vLLM, Ollama)를 사용할 수 있나요?
  • OpenClaw, Flawd, Krill은 어떤 모델을 사용합니까?
  • 재시작 없이 즉시 모델을 전환할 수 있나요?
  • 일상 업무에는 GPT 5.2를, 코딩에는 Codex 5.3를 사용할 수 있나요?
  • “모델 … 허용되지 않음”이라고 하고 응답이 없는 이유는?
  • “Unknown model: minimax/MiniMax-M2.1” 메시지를 보는 이유는 무엇인가요?
  • MiniMax를 기본값으로 사용하고 복잡한 작업에 OpenAI를 사용할 수 있나요?
  • opus / sonnet / gpt는 내장된 단축키인가요?
  • 모델 단축키(별칭)를 어떻게 정의/재정의하나요?
  • OpenRouter 또는 Z.AI와 같은 다른 프로바이더에서 모델을 어떻게 추가합니까?
• 모델 장애 조치 및 “모든 모델 실패”
  • 장애 조치는 어떻게 작동하나요?
  • 이 오류는 무엇을 의미합니까?
  • No credentials found for profile "anthropic:default"에 대한 수정 체크리스트
  • Google Gemini도 시도하고 실패한 이유는?
• 인증 프로파일: 그것들이 무엇이며 어떻게 관리하나요
  • 인증 프로파일이란 무엇인가요?
  • 일반적인 프로파일 ID는 무엇인가요?
  • 어떤 인증 프로파일을 먼저 시도할지 제어할 수 있나요?
  • OAuth와 API 키: 차이점은 무엇인가요?
• 게이트웨이: 포트, “이미 실행 중”, 원격 모드
  • 게이트웨이는 어떤 포트를 사용하나요?
  • 왜 openclaw gateway status는 Runtime: running이라고 하지만 RPC probe: failed라고 합니까?
  • 왜 openclaw gateway status는 Config (cli)와 Config (service)가 다르다고 표시합니까?
  • “또 다른 게이트웨이 인스턴스가 이미 수신 중”이라는 메시지는 무엇을 의미하나요?
  • OpenClaw를 원격 모드에서 어떻게 실행하나요 (클라이언트가 다른 곳에 있는 게이트웨이에 연결)?
  • 제어 UI가 “토큰 없음” (또는 계속 재연결 중)이라고 합니다. 이제 어떻게 하나요?
  • gateway.bind: "tailnet"을 설정했지만 바인드할 수 없거나 아무것도 수신하지 않습니다
  • 같은 호스트에서 여러 게이트웨이를 실행할 수 있나요?
  • “잘못된 핸드셰이크” / 코드 1008은 무엇을 의미합니까?
• 로깅 및 디버깅
  • 로그는 어디에 있나요?
  • 게이트웨이 서비스를 시작/중지/재시작하는 방법은?
  • Windows에서 터미널을 닫았습니다 - OpenClaw를 어떻게 다시 시작하나요?
  • 게이트웨이는 실행 중이지만 응답이 도착하지 않습니다. 무엇을 확인해야 하나요?
  • “게이트웨이와의 연결이 끊어졌습니다. 이유 없음” - 이제 어떻게 해야 하나요?
  • Telegram setMyCommands가 네트워크 오류로 실패합니다. 무엇을 확인해야 하나요?
  • TUI가 출력을 표시하지 않습니다. 무엇을 확인해야 하나요?
  • 게이트웨이를 완전히 중지한 다음 다시 시작하려면 어떻게 합니까?
  • 간단하게 설명: openclaw gateway restart와 openclaw gateway
  • 무엇인가 잘못되었을 때 정보를 가장 빠르게 얻는 방법은 무엇인가요?
• 미디어 및 첨부파일
  • 내 스킬이 이미지/PDF를 생성했지만 전송되지 않았습니다
• 보안 및 접근 제어
  • OpenClaw를 인바운드 다이렉트 메시지에 공개하는 것이 안전한가요?
  • 프롬프트 인젝션은 공용 봇에만 해당되는 문제입니까?
  • 봇이 독자적인 이메일, GitHub 계정, 전화번호를 가져야 합니까?
  • 텍스트 메시지에 대한 자율 권한을 제공할 수 있으며 그것이 안전한가요?
  • 개인 비서 작업에 더 저렴한 모델을 사용할 수 있나요?
  • Telegram에서 /start를 실행했지만 페어링 코드를 받지 못했습니다
  • WhatsApp: 내 연락처에게 메시지를 보내나요? 페어링은 어떻게 작동하나요?
• 채팅 명령, 작업 중지 및 “멈추지 않음”
  • 내부 시스템 메시지가 채팅에 표시되지 않도록 하려면 어떻게 합니까
  • 실행 중인 작업을 중지/취소하려면 어떻게 합니까?
  • Telegram에서 Discord 메시지를 보내려면 어떻게 합니까? (“교차 컨텍스트 메시징 거부됨”)
  • 봇이 “빨리 쏟아지는” 메시지를 “무시”하는 것처럼 보이는 이유는?

​

문제가 발생했을 때 처음 60초

1. 빠른 상태 확인 (첫 번째 확인)
   복사

   AI에게 묻기

   openclaw status
   
   빠른 로컬 요약: OS + 업데이트, 게이트웨이/서비스 도달 가능성, 에이전트/세션, 프로바이더 설정 + 런타임 문제 (게이트웨이에 도달할 수 있을 경우).
2. 공유 가능한 보고서 (공유 안전함)
   복사

   AI에게 묻기

   openclaw status --all
   
   로그 끝자락을 포함하여 읽기 전용 진단 (토큰은 수정됨).
3. 데몬 + 포트 상태
   복사

   AI에게 묻기

   openclaw gateway status
   
   감독자 런타임과 RPC 도달 가능성, 프로브 대상 URL, 서비스가 사용했을 것으로 예상되는 설정을 보여줌.
4. 심층 프로브
   복사

   AI에게 묻기

   openclaw status --deep
   
   게이트웨이 상태 확인 + 프로바이더 프로브 실행 (도달할 수 있는 게이트웨이 필요). Health 참조.
5. 최신 로그 추적
   복사

   AI에게 묻기

   openclaw logs --follow
   
   RPC가 다운된 경우, 다음을 사용:
   복사

   AI에게 묻기

   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   파일 로그는 서비스 로그와 별도입니다; Logging 및 Troubleshooting 참조.
6. 의사 실행 (수리)
   복사

   AI에게 묻기

   openclaw doctor
   
   설정/상태 수리/마이그레이션 + 상태 확인 실행. Doctor 참조.
7. 게이트웨이 스냅샷
   복사

   AI에게 묻기

   openclaw health --json
   openclaw health --verbose   # 오류 시 대상 URL + 설정 경로 보여줌
   
   실행 중인 게이트웨이에 전체 스냅샷 요청 (WS 전용). Health 참조.

​

빠른 시작 및 첫 실행 설정

​

막혔습니다. 문제를 가장 빠르게 해결하는 방법은 무엇인가요?

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

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

openclaw status
openclaw models status
openclaw doctor

• openclaw status: 게이트웨이/에이전트 상태 및 기본 설정의 빠른 스냅숏.
• openclaw models status: 프로바이더 인증 및 모델 가용성을 확인합니다.
• openclaw doctor: 일반적인 구성/상태 문제를 검증하고 수리합니다.

​

OpenClaw를 설치하고 설정하는 권장 방법은 무엇인가요

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # 첫 실행 시 UI 종속성을 자동 설치합니다
openclaw onboard

​

온보딩 후 대시보드를 어떻게 여나요

​

로컬호스트와 원격에서 대시보드 토큰을 어떻게 인증하나요

• http://127.0.0.1:18789/를 엽니다.
• 인증 요청이 있으면 gateway.auth.token (또는 OPENCLAW_GATEWAY_TOKEN)에서 토큰을 Control UI 설정에 붙여넣으세요.
• 게이트웨이 호스트에서 openclaw config get gateway.auth.token으로 토큰을 가져오세요 (또는 openclaw doctor --generate-gateway-token으로 생성하세요).

• Tailscale Serve (권장): 루프백을 유지하고, openclaw gateway --tailscale serve를 실행하여 https://<magicdns>/를 엽니다. gateway.auth.allowTailscale이 true이면, 인증 헤더가 Control UI/WebSocket 인증을 만족시킵니다 (토큰 불필요, 신뢰할 수 있는 게이트웨이 호스트 가정); HTTP API는 여전히 토큰/비밀번호가 필요합니다.
• Tailnet 바인드: openclaw gateway --bind tailnet --token "<token>"을 실행하고, http://<tailscale-ip>:18789/을 열어 대시보드 설정에 토큰을 붙여넣으세요.
• SSH 터널: ssh -N -L 18789:127.0.0.1:18789 user@host를 실행한 후, http://127.0.0.1:18789/을 열고 Control UI 설정에 토큰을 붙여넣으세요.

​

어떤 런타임이 필요하나요

​

Raspberry Pi에서 실행되나요

​

Raspberry Pi 설치 팁이 있나요

• 64비트 OS를 사용하고 Node >= 22를 유지하세요.
• 로그를 보고 빠르게 업데이트할 수 있도록 해커블 (git) 설치를 선호하세요.
• 채널/스킬 없이 시작한 다음 하나씩 추가하세요.
• 이상한 이진 문제를 만나면, 이는 대개 ARM 호환성 문제입니다.

​

친구 온보딩이 멈추고 깨어나지 않습니다. 이제 어떻게 해야 하나요

1. 게이트웨이를 재시작 합니다:

openclaw gateway restart

2. 상태 및 인증을 확인합니다:

openclaw status
openclaw models status
openclaw logs --follow

3. 아직도 멈춘다면, 명령을 실행합니다:

openclaw doctor

​

재설치 없이 새 머신 Mac mini로 설정을 이전할 수 있나요

1. 새 머신에 OpenClaw를 설치합니다.
2. 이전 머신에서 $OPENCLAW_STATE_DIR (기본값: ~/.openclaw)을 복사합니다.
3. 작업 공간을 복사합니다 (기본값: ~/.openclaw/workspace).
4. openclaw doctor를 실행하고 게이트웨이 서비스를 재시작합니다.

​

최신 버전의 새로운 사항을 어디서 확인할 수 있나요

​

docs.openclaw.ai에 SSL 오류가 표시됩니다. 이제 어떻게 해야 하나요

​

안정 버전과 베타 버전의 차이점은 무엇인가요

• latest = 안정
• beta = 테스트를 위한 초기 빌드

​

베타 버전을 설치하는 방법과 베타, 개발 버전의 차이점

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

​

설치 및 온보딩에는 보통 얼마나 시간이 걸리나요

• 설치: 2-5분
• 온보딩: 설정한 채널/모델 수에 따라 5-15분 소요

​

최신 기능을 어떻게 체험할 수 있나요

1. 개발 채널 (git 체크아웃):

openclaw update --channel dev

2. 해커블 설치 (설치 사이트에서):

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

​

설치 프로그램이 중단되었습니다. 더 많은 피드백을 얻을 수 있는 방법은 무엇인가요?

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

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

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

# install.ps1은 아직 전용 -Verbose 플래그가 없습니다.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

​

Windows 설치에서 git을 찾지 못하거나 openclaw를 인식하지 못합니다

• Git for Windows를 설치하고 git이 PATH에 있는지 확인하세요.
• PowerShell을 닫았다가 다시 열고, 설치 프로그램을 다시 실행하세요.

• 여러분의 npm 글로벌 bin 폴더가 PATH에 없습니다.
• 경로를 확인하세요:
  복사

  AI에게 묻기

  npm config get prefix
  
• <prefix>\\bin이 PATH에 있는지 확인하세요 (대부분의 시스템에서는 %AppData%\\npm입니다).
• PATH를 업데이트한 후 PowerShell을 닫았다가 다시 여세요.

​

문서가 질문에 대해 답변하지 않았습니다. 더 나은 답변을 어떻게 얻을 수 있나요?

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

​

Linux에 OpenClaw를 어떻게 설치하나요

• Linux 빠른 경로 + 서비스 설치: Linux.
• 전체 단계별 설명: 시작하기.
• 설치 프로그램 + 업데이트: 설치 및 업데이트.

​

VPS에 OpenClaw를 어떻게 설치하나요

​

CloudVPS 설치 가이드는 어디에 있나요

• VPS 호스팅 (모든 프로바이더를 한곳에)
• Fly.io
• Hetzner
• exe.dev

​

OpenClaw에게 스스로 업데이트하도록 요청할 수 있나요

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

openclaw update --yes --no-restart
openclaw gateway restart

​

온보딩 마법사는 실제로 무엇을 하나요

• 모델/인증 설정 (Anthropic 설정-토큰을 Claude 구독에 권장, OpenAI Codex OAuth 지원, API 키 선택 가능, LM Studio 로컬 모델 지원)
• 작업 공간 위치 및 부트스트랩 파일
• 게이트웨이 설정 (바인드/포트/인증/Tailscale)
• 프로바이더 (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
• 데몬 설치 (macOS에서는 LaunchAgent; Linux/WSL2에서는 systemd 사용자 유닛)
• 상태 검사 및 스킬 선택

​

이 프로그램을 실행하려면 Claude 또는 OpenAI 구독이 필요한가요

​

Claude Max 구독을 API 키 없이 사용할 수 있나요

​

Anthropic 설정-토큰 인증은 어떻게 작동하나요

​

Anthropic 설정-토큰은 어디서 찾을 수 있나요?

claude setup-token

​

Claude 구독 인증 (Claude Pro 또는 Max)을 지원하나요

​

Anthropic에서 HTTP 429 ratelimiterror가 표시되는 이유는 무엇인가요?

​

AWS Bedrock이 지원되나요

​

Codex 인증은 어떻게 작동하나요

​

OpenAI 구독 Codex OAuth를 지원하나요

​

Gemini CLI OAuth는 어떻게 설정하나요

1. 플러그인을 활성화합니다: openclaw plugins enable google-gemini-cli-auth
2. 로그인합니다: openclaw models auth login --provider google-gemini-cli --set-default

​

캐주얼한 채팅에 로컬 모델이 괜찮을까요

​

호스팅 된 모델 트래픽을 특정 지역에 유지하려면 어떻게 해야하나요

​

이 프로그램을 설치하려면 Mac Mini를 구매해야 하나요

​

iMessage 지원을 위해 Mac mini가 필요합니까?

• 게이트웨이는 Linux/VPS에서 실행하고, BlueBubbles 서버는 메시지에 로그인된 어떤 Mac에서도 실행합니다.
• 가장 간단한 단일 머신 설정을 원하면 모든 것을 Mac에서 실행합니다.

​

Mac mini를 구매해서 OpenClaw를 실행하면 MacBook Pro에 연결할 수 있나요

• Mac mini에서 게이트웨이 (항상 켜진 상태).
• MacBook Pro는 macOS 앱 또는 노드 호스트를 실행하고 게이트웨이에 페어링합니다.
• openclaw nodes status / openclaw nodes list를 사용하여 확인합니다.

​

Bun을 사용할 수 있나요

​

Telegram에서 allowFrom에 무엇을 넣어야 하나요

• 봇에게 다이렉트 메시지를 보내고, openclaw logs --follow를 실행하여 from.id를 읽습니다.

• 봇에게 다이렉트 메시지를 보내고, https://api.telegram.org/bot<bot_token>/getUpdates를 호출하여 message.from.id를 읽습니다.

• @userinfobot 또는 @getidsbot에게 다이렉트 메시지를 보냅니다.

​

다른 OpenClaw 인스턴스에서 한 WhatsApp 번호를 여러 명이 사용할 수 있나요

​

빠른 채팅 에이전트와 코딩 에이전트용 Opus를 실행할 수 있나요

​

Linux에서 Homebrew가 작동하나요

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>

​

해커블 git 설치와 npm 설치의 차이점은 무엇인가요

• 해커블 (git) 설치: 전체 소스 체크아웃, 편집 가능, 기여자에게 최적의 선택. 로컬에서 빌드를 실행할 수 있고 코드/문서를 패치할 수 있습니다.
• npm 설치: 전역 CLI 설치, 저장소 없음, “그냥 실행하기”에 적합. 업데이트는 npm 배포 태그에서 제공합니다.

​

나중에 npm과 git 설치 간 전환할 수 있나요

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

npm install -g openclaw@latest
openclaw doctor
openclaw gateway restart

​

게이트웨이를 랩톱이나 VPS에서 실행해야 하나요

• 장점: 서버 비용 없음, 로컬 파일에 즉시 접근 가능, 라이브 브라우저 창.
• 단점: 잠자기/네트워크 드롭 = 연결 끊김, 운영 체제 업데이트/재부팅은 끊김을 초래, 계속 깨어 있어야 함.

• 장점: 항상 켜져 있음, 안정적인 네트워크, 노트북 절전 문제 없음, 계속 실행하기 쉽습니다.
• 단점: 대개 헤드리스 실행 (스크린샷 사용), 원격 파일 접근만 가능, 업데이트를 위해 SSH가 필요합니다.

​

OpenClaw를 전용 머신에서 실행하는 것이 얼마나 중요한가요

• 전용 호스트 (VPS/Mac mini/Pi): 항상 켜져 있고, 절전/재부팅이 적으며, 권한이 깨끗하며, 계속 실행하기 쉽습니다.
• 공유 랩톱/데스크탑: 테스트와 적극적 사용에는 충분하지만, 머신이 절전 모드로 들어가거나 업데이트될 때마다 중단될 수 있습니다.

​

최소 VPS 요구 사항과 권장 OS는 무엇인가요

• 절대 최소: 1 vCPU, 1GB RAM, ~500MB 디스크.
• 권장: 1-2 vCPU, 2GB RAM 이상 여유 공간이 필요할 경우 (로그, 미디어, 여러 채널). 노드 도구와 브라우저 자동화는 많은 자원을 소비할 수 있습니다.

​

OpenClaw를 VM에서 실행할 수 있으며 요구 사항은 무엇인가요

• 절대 최소: 1 vCPU, 1GB RAM.
• 권장: 여러 채널, 브라우저 자동화 또는 미디어 도구를 실행하는 경우 2GB 이상의 RAM.
• OS: Ubuntu LTS 또는 최신 Debian/Ubuntu.

​

OpenClaw란 무엇인가?

​

OpenClaw를 한 문단으로 설명하기

​

가치 제안

• 사용자의 장치, 사용자의 데이터: 게이트웨이를 원하는 곳 (Mac, Linux, VPS)에서 실행하고, 작업공간 및 세션 기록을 로컬에 유지합니다.
• 웹 샌드박스가 아닌 실제 채널: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/등과 지원되는 플랫폼에서는 모바일 음성과 Canvas도 가능.
• 모델 비종속적: Anthropic, OpenAI, MiniMax, OpenRouter 등을 사용할 수 있으며, 에이전트 별 라우팅 및 페일오버가 가능합니다.
• 로컬 전용 옵션: 로컬 모델을 실행하여 모든 데이터를 사용자의 장치에 유지할 수 있습니다.
• 멀티 에이전트 라우팅: 채널, 계정 또는 작업별로 개별 에이전트를 분리하여 각각 고유한 작업공간과 기본 설정을 가집니다.
• 오픈 소스 및 확장 가능성: 공급업체 종속 없이 검사, 확장 및 자체 호스팅이 가능합니다.

​

설정을 완료했습니다. 무엇을 먼저 해야 하나요

• 웹사이트 구축 (WordPress, Shopify, 또는 간단한 정적 사이트).
• 모바일 앱 프로토타입 (개요, 화면, API 계획).
• 파일 및 폴더 정리 (정리, 네이밍, 태깅).
• Gmail 연결 및 요약 자동화 또는 후속 작업 자동화.

​

OpenClaw의 일상적인 주요 사용 사례 다섯 가지는 무엇인가요

• 개인 브리핑: 관심 있는 받은 편지함, 일정 및 뉴스 요약.
• 리서치 및 초안 작성: 이메일 또는 문서의 빠른 리서치, 요약, 초안 작성.
• 리마인더 및 후속 작업: 크론 또는 하트비트 기반 독촉 및 체크리스트.
• 브라우저 자동화: 폼 입력, 데이터 수집, 웹 작업 반복.
• 디바이스 간 조정: 휴대폰에서 작업을 보내고, 게이트웨이가 서버에서 실행하며 결과를 채팅에서 받음.

​

OpenClaw가 SaaS를 위한 리드 생성 아웃리치 광고 및 블로그에 도움을 줄 수 있나요

​

웹 개발을 위한 Claude Code와 비교한 장점은 무엇인가요

• 세션 간 지속 메모리 및 작업공간
• 멀티 플랫폼 접근 (WhatsApp, Telegram, TUI, WebChat)
• 도구 오케스트레이션 (브라우저, 파일, 일정 관리, 후크)
• 항상 켜진 게이트웨이 (VPS에서 실행, 어디서든지 상호작용)
• 노드를 통한 로컬 브라우저/화면/카메라/실행

​

스킬 및 자동화

​

리포를 더럽히지 않고 스킬을 커스터마이즈 하려면 어떻게 하나요

​

사용자 지정 폴더에서 스킬을 로드할 수 있나요

​

다른 작업에 다른 모델을 사용하는 방법

• 크론 작업: 격리된 작업은 작업별로 model 오버라이드를 설정할 수 있습니다.
• 하위 에이전트: 작업을 서로 다른 기본 모델을 사용하는 별도의 에이전트로 라우팅합니다.
• 요청 시 전환: /model을 사용하여 언제든지 현재 세션의 모델을 전환하세요.

​

봇이 무거운 작업을 할 때 멈춥니다. 이를 어떻게 오프로드하나요

​

Discord에서 스레드 바인딩 서브에이전트 세션은 어떻게 작동하나요

• sessions_spawn에서 thread: true를 사용하여 생성합니다 (지속적인 후속 작업을 위해 선택적으로 mode: "session").
• 또는 /focus <target>으로 수동으로 바인딩합니다.
• /agents로 바인딩 상태를 확인합니다.
• /session ttl <duration|off>로 자동 해제를 제어합니다.
• /unfocus로 스레드를 분리합니다.

• 글로벌 기본값: session.threadBindings.enabled, session.threadBindings.ttlHours.
• Discord 오버라이드: channels.discord.threadBindings.enabled, channels.discord.threadBindings.ttlHours.
• 생성 시 자동 바인딩: channels.discord.threadBindings.spawnSubagentSessions: true 설정.

​

크론이나 리마인더가 실행되지 않습니다. 무엇을 확인해야 하나요

• 크론이 활성화되어 있는지 확인 (cron.enabled), 그리고 OPENCLAW_SKIP_CRON이 설정되어 있지 않은지 확인.
• 게이트웨이가 24/7 작동 중인지 확인 (슬립/재시작 없음).
• 작업의 시간대 설정을 확인 (--tz vs 호스트 시간대).

openclaw cron run <jobId> --force
openclaw cron runs --id <jobId> --limit 50

​

Linux에서 스킬을 어떻게 설치하나요

npm i -g clawhub

pnpm add -g clawhub

​

OpenClaw가 일정에 따라 또는 백그라운드에서 계속 실행할 수 있나요

• 크론 작업은 예약된 또는 반복 작업을 위해 (재시작 중에도 지속됨).
• 하트비트는 “주 세션” 주기적 검사.
• 격리 작업은 요약을 게시하거나 채팅에 전달하는 자율 에이전트.

​

Linux에서 Apple macOS 전용 스킬을 실행할 수 있나요?

1. 바이너리의 SSH 래퍼 생성 (예: Apple Notes 용 memo):
   복사

   AI에게 묻기

   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. Linux 호스트의 PATH에 래퍼를 두세요 (예: ~/bin/memo).
3. 스킬 메타데이터를 오버라이드하여 (작업공간 또는 ~/.openclaw/skills) Linux를 허용:
   복사

   AI에게 묻기

   ---
   name: apple-notes
   description: Manage Apple Notes via the memo CLI on macOS.
   metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }
   ---
   
4. 스킬 스냅샷을 새로고침하기 위해 새로운 세션을 시작합니다.

​

Notion 또는 HeyGen 통합이 있나요

• 사용자 정의 스킬 / 플러그인: 신뢰할 수 있는 API 액세스에 적합 (Notion/HeyGen 모두 API가 있음).
• 브라우저 자동화: 코드 없이 작동하지만 느리고 불안정합니다.

• 클라이언트당 하나의 Notion 페이지 (컨텍스트 + 선호도 + 활성 작업).
• 세션 시작 시 해당 페이지를 검색하도록 에이전트에게 요청.

clawhub install <skill-slug>
clawhub update --all

​

브라우저 인수용 Chrome 확장을 설치하려면 어떻게 하나요

openclaw browser extension install
openclaw browser extension path

​

샌드박스 격리 및 메모리

​

전용 샌드박스 격리 문서가 있나요

​

Docker가 제한적으로 느껴집니다. 전체 기능을 활성화하려면 어떻게 하나요

• 캐시를 유지할 수 있도록 OPENCLAW_HOME_VOLUME으로 /home/node를 지속시킵니다.
• OPENCLAW_DOCKER_APT_PACKAGES로 시스템 종속성을 이미지에 삽입합니다.
• 번들된 CLI를 통해 Playwright 브라우저를 설치합니다: node /app/node_modules/playwright-core/cli.js install chromium
• PLAYWRIGHT_BROWSERS_PATH를 설정하고 경로가 지속되도록 확인합니다.

​

샌드박스에 호스트 폴더를 바인딩하려면 어떻게 하나요

​

메모리는 어떻게 작동하나요

• 일일 노트는 memory/YYYY-MM-DD.md에 기록됩니다.
• 큐레이션된 장기 노트는 MEMORY.md에 기록됩니다 (주요/개인 세션만).

​

메모리가 계속 무언가를 잊어버립니다. 어떻게 고정할 수 있나요

​

시맨틱 메모리 검색에 OpenAI API 키가 필요하나요

​

메모리는 영구적으로 지속되나요. 제한은 무엇인가요

​

디스크에 정보 저장 위치

​

OpenClaw와 함께 사용된 모든 데이터가 로컬에 저장되나요

• 기본적으로 로컬: 세션, 메모리 파일, 설정, 워크스페이스는 게이트웨이 호스트 (~/.openclaw + 워크스페이스 디렉토리)에 존재합니다.
• 필수적으로 원격: 모델 프로바이더(Anthropic/OpenAI/등)에 보낸 메시지는 그들의 API로 전송되며, 채팅 플랫폼(WhatsApp/Telegram/Slack/등)은 메시지 데이터를 그들의 서버에 저장합니다.
• 관리 가능한 범위: 로컬 모델을 사용하면 프롬프트가 기기에 남아 있지만, 채널 트래픽은 여전히 채널의 서버를 통해 전달됩니다.

​

OpenClaw는 데이터를 어디에 저장하나요

​

AGENTSmd SOULmd USERmd MEMORYmd는 어디에 있어야 하나요

• 워크스페이스 (에이전트별): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (또는 memory.md), memory/YYYY-MM-DD.md, 선택적 HEARTBEAT.md.
• 상태 디렉터리 (~/.openclaw): 설정, 자격 증명, 인증 프로파일, 세션, 로그, 및 공유 스킬 (~/.openclaw/skills).

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

추천 백업 전략은 무엇인가요

​

OpenClaw를 완전히 제거하려면 어떻게 해야 하나요

​

에이전트가 워크스페이스 외부에서 작동할 수 있나요

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

원격 모드에 있을 때 세션 저장소는 어디에 있나요

​

설정 기본 사항

​

설정 형식은 무엇이며 어디에 있나요

$OPENCLAW_CONFIG_PATH

​

gatewaybind lan 또는 tailnet으로 설정했는데 아무것도 듣지 않습니다 UI가 허가되지 않았다고 말합니다

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• gateway.remote.token은 원격 CLI 호출 전용이며, 로컬 게이트웨이 인증을 활성화하지 않습니다.
• Control UI는 connect.params.auth.token을 통해 인증합니다 (앱/UI 설정에 저장됨). 토큰을 URL에 넣지 마세요.

​

지금 로컬 호스트에서 토큰이 필요한 이유는 무엇인가요

​

설정 변경 후 재시작해야 하나요

• gateway.reload.mode: "hybrid" (기본값): 안전한 변경사항은 핫 적용, 중요한 변경사항은 재시작
• hot, restart, off도 지원됩니다

​

웹 검색 및 웹 가져오기를 어떻게 활성화하나요

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
      },
      fetch: {
        enabled: true,
      },
    },
  },
}

• 허용 목록을 사용하는 경우, web_search/web_fetch 또는 group:web을 추가하세요.
• 기본적으로 web_fetch는 활성화되어 있습니다 (명시적으로 비활성화되지 않는 한).
• 데몬은 ~/.openclaw/.env (또는 서비스 환경)에서 환경 변수를 읽습니다.

​

여러 장치에서 특수 작업자와 함께 중앙 게이트웨이를 실행하려면 어떻게 해야 하나요

• 게이트웨이 (중앙): 채널 (Signal/WhatsApp), 라우팅 및 세션 소유.
• 노드 (장치): Mac/iOS/Android는 외부 장치로 연결되고 로컬 도구 (system.run, canvas, camera)를 노출합니다.
• 에이전트 (작업자): 특수 역할을 위해 별도의 브레인/워크스페이스 (예: “Hetzner ops”, “개인 데이터”).
• 하위 에이전트: 병렬 처리를 원할 때 메인 에이전트에서 백그라운드 작업 생성.
• TUI: 게이트웨이에 연결하고 에이전트/세션 전환.

​

OpenClaw 브라우저는 헤드리스로 실행할 수 있나요

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}

• 보이는 브라우저 창이 없습니다 (비주얼이 필요하면 스크린샷을 사용하세요).
• 일부 사이트는 헤드리스 모드에서 자동화에 대해 더욱 엄격합니다 (캡챠, 안티 봇). 예를 들어, X/Twitter는 종종 헤드리스 세션을 차단합니다.

​

브라우저 제어를 위해 Brave를 사용하려면 어떻게 해야 하나요

​

원격 게이트웨이와 노드

​

Telegram, 게이트웨이 및 노드 간의 명령은 어떻게 전파되나요

​

게이트웨이가 원격에 호스팅될 때 에이전트가 내 컴퓨터에 액세스할 수 있는 방법은 무엇인가요

1. 항상 켜져 있는 호스트 (VPS/홈 서버)에서 게이트웨이를 실행하세요.
2. 게이트웨이 호스트 + 로컬 컴퓨터를 같은 tailnet에 두세요.
3. 게이트웨이 WS가 접근 가능한지 확인하세요 (tailnet bind 또는 SSH 터널).
4. 로컬에서 macOS 앱을 열고 Remote over SSH 모드 (또는 직렬 tailnet)로 연결하여 노드로 등록합니다.
5. 게이트웨이에서 노드를 승인합니다:
   복사

   AI에게 묻기

   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Tailscale은 연결되었지만 응답이 없습니다. 이제 무엇을 해야 하나요

• 게이트웨이가 실행 중인지: openclaw gateway status
• 게이트웨이 상태: openclaw status
• 채널 상태: openclaw channels status

• Tailscale Serve를 사용하는 경우, gateway.auth.allowTailscale이 올바르게 설정되어 있는지 확인하세요.
• SSH 터널을 통해 연결하는 경우, 로컬 터널이 작동 중이며 올바른 포트를 가리키고 있는지 확인하세요.
• 허용 목록 (다이렉트 메시지 또는 그룹)에 자신의 계정이 있는지 확인하세요.

​

두 OpenClaw 인스턴스는 서로 대화할 수 있나요 로컬 VPS

openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>

​

여러 에이전트를 위해 별도의 VPS가 필요한가요

​

개인 랩톱에서 노드를 사용하는 것이 VPS에서 SSH로 접속하는 것보다 이점이 있나요

• 인바운드 SSH가 필요 없습니다. 노드는 게이트웨이 WebSocket으로 연결하며 장치 페어링을 사용합니다.
• 안전한 실행 제어. system.run은 해당 랩톱의 노드 허용 목록/승인을 통해 제한됩니다.
• 더 많은 장치 도구. 노드는 canvas, camera, screen을 system.run 외에도 노출합니다.
• 로컬 브라우저 자동화. 게이트웨이는 VPS에 유지하되, Chrome을 로컬에서 실행하고 Chrome 확장 프로그램 + 랩톱의 노드 호스트로 제어를 중계합니다.

​

두 번째 랩톱에 설치해야 하나요 아니면 그냥 노드를 추가하면 되나요

​

노드에서 게이트웨이 서비스를 실행하나요

​

설정을 적용하는 API RPC 방법이 있나요

​

config.apply로 인해 설정이 사라졌습니다 이를 복구하고 피하려면 어떻게 해야 하나요

• 백업에서 복원 (git 또는 복사된 ~/.openclaw/openclaw.json).
• 백업이 없는 경우, openclaw doctor를 다시 실행하여 채널/모델을 다시 설정합니다.
• 예상치 않은 경우, 마지막에 알고 있는 구성이나 백업을 포함하여 버그를 신고하세요.
• 로칼 코딩 에이전트가 종종 로그나 히스토리에서 작동 가능한 구성을 재구성할 수 있습니다.

• 작은 변경에는 openclaw config set을 사용하세요.
• 대화형 편집에는 openclaw configure를 사용하세요.

​

첫 설치를 위한 최소한의 깨끗한 설정은 무엇인가요

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

VPS에서 Tailscale을 설정하고 Mac에서 연결하려면 어떻게 해야 하나요

1. VPS에서 설치 및 로그인
   복사

   AI에게 묻기

   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. Mac에서 설치 및 로그인
   • Tailscale 앱을 사용하고 동일한 tailnet에 로그인하세요.
3. MagicDNS 활성화 (권장)
   • Tailscale 관리 콘솔에서 MagicDNS를 활성화하여 VPS에 안정적인 이름을 부여하세요.
4. tailnet 호스트 이름 사용
   • SSH: ssh user@your-vps.tailnet-xxxx.ts.net
   • Gateway WS: ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

원격 게이트웨이에 Mac 노드를 어떻게 연결하나요 Tailscale Serve

1. VPS + Mac이 동일한 tailnet에 있는지 확인하세요.
2. macOS 앱을 원격 모드로 사용하세요 (SSH 대상은 tailnet 호스트 이름일 수 있음). 앱은 게이트웨이 포트를 터널링하고 노드로 연결할 것입니다.
3. 게이트웨이에서 노드를 승인하세요:
   복사

   AI에게 묻기

   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

환경 변수 및 .env 로드

​

OpenClaw는 환경 변수를 어떻게 로드하나요

• 현재 작업 디렉토리의 .env
• ~/.openclaw/.env (즉, $OPENCLAW_STATE_DIR/.env)의 글로벌 폴백 .env

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

게이트웨이를 서비스로 시작했는데 내 환경 변수가 사라졌습니다. 이제 무엇을 해야 하나요

1. 빠진 키를 ~/.openclaw/.env에 넣어 서비스가 셸 환경을 상속하지 않을 때도 이를 인식하도록 합니다.
2. 셸 가져오기 기능을 활성화하세요 (선택적 편리함):

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

COPILOTGITHUBTOKEN을 설정했지만 모델 상태에서 Shell env가 꺼져 있다고 나오는 이유는 무엇인가요

1. 토큰을 ~/.openclaw/.env에 넣으세요:
   복사

   AI에게 묻기

   COPILOT_GITHUB_TOKEN=...
   
2. 또는 셸 가져오기를 활성화하세요 (env.shellEnv.enabled: true).
3. 또는 설정 env 블록에 추가하시되 (누락된 경우에만 적용됩니다).

openclaw models status

​

세션 및 여러 채팅

​

새로운 대화를 어떻게 시작하나요

​

새 메시지를 보내지 않으면 세션이 자동으로 재설정되나요

{
  session: {
    idleMinutes: 240,
  },
}

​

OpenClaw 인스턴스 팀을 한 CEO와 여러 에이전트로 만들 수 있나요

​

작업 중에 컨텍스트가 잘린 이유와 이를 방지하는 방법은 무엇인가요

• 현재 상태를 요약하여 파일에 기록하도록 봇에게 요청합니다.
• 긴 작업 전에 /compact을 사용하고 주제를 전환할 때 /new을 사용합니다.
• 중요한 컨텍스트를 워크스페이스에 유지하고 봇에게 다시 읽도록 요청합니다.
• 메인 채팅이 더 작도록 하위 에이전트를 사용해 긴 작업이나 병렬 작업을 처리합니다.
• 이 문제가 자주 발생하면 더 큰 컨텍스트 윈도우를 가진 모델을 선택하십시오.

​

OpenClaw를 완전히 재설정하되 설치 상태를 유지하려면 어떻게 하나요

openclaw reset

openclaw reset --scope full --yes --non-interactive

openclaw onboard --install-daemon

• 온보딩 마법사는 기존 설정을 감지하면 Reset을 제공합니다. Wizard를 참조하세요.
• 프로필을 사용했다면 (--profile / OPENCLAW_PROFILE), 각 상태 디렉터리를 재설정하세요 (기본값은 ~/.openclaw-<profile>입니다).
• 개발자 재설정: openclaw gateway --dev --reset (개발자 전용; 개발 설정 + 자격 증명 + 세션 + 워크스페이스를 모두 삭제).

​

컨텍스트가 너무 크다는 오류가 발생할 때 어떻게 재설정하거나 압축하나요

• 압축 (대화를 유지하면서 오래된 턴을 요약):
  복사

  AI에게 묻기

  /compact
  
  또는 요약을 유도하기 위한 /compact <instructions>를 사용합니다.
• 재설정 (같은 채팅 키에 대한 새 세션 ID):
  복사

  AI에게 묻기

  /new
  /reset
  

• 세션 트리밍을 활성화하거나 조정하여 오래된 도구 출력을 다듬습니다 (agents.defaults.contextPruning).
• 더 큰 컨텍스트 윈도우를 가진 모델을 사용합니다.

​

”LLM 요청 거부됨: messages.content.tool_use.input 필드 필요”가 표시되는 이유는 무엇인가요

​

왜 30분마다 하트비트 메시지가 나타나나요

{
  agents: {
    defaults: {
      heartbeat: {
        every: "2h", // 또는 "0m"로 비활성화
      },
    },
  },
}

​

WhatsApp 그룹에 봇 계정을 추가해야 하나요

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

WhatsApp 그룹의 JID를 어떻게 얻나요

openclaw logs --follow --json

openclaw directory groups list --channel whatsapp

​

왜 OpenClaw가 그룹에서 응답하지 않나요

• 멘션 게이팅이 켜져 있습니다 (기본). 봇을 @멘션해야 하거나 mentionPatterns와 일치해야 합니다.
• "*" 없이 channels.whatsapp.groups를 구성했으며 그룹이 허용 목록에 포함되지 않았습니다.

​

그룹/스레드가 다이렉트 메시지와 컨텍스트를 공유하나요

​

몇 개의 워크스페이스와 에이전트를 만들 수 있나요

• 디스크 증가: 세션 + 대화록은 ~/.openclaw/agents/<agentId>/sessions/ 폴더 아래에 존재합니다.
• 토큰 비용: 더 많은 에이전트는 더 많은 동시 모델 사용을 의미합니다.
• 운영 오버헤드: 에이전트별 인증 프로필, 워크스페이스 및 채널 라우팅.

• 각 에이전트당 하나의 활성 워크스페이스를 유지합니다 (agents.defaults.workspace).
• 디스크가 증가하면 오래된 세션(삭제 JSONL 또는 저장 항목)을 정리합니다.
• openclaw doctor를 사용하여 잘못된 워크스페이스 및 프로필 불일치를 찾습니다.

​

여러 슬랙 봇이나 채팅을 동시에 실행할 수 있나요? 어떻게 설정해야 하나요

• 상시 켜짐 게이트웨이 호스트 (VPS/Mac mini).
• 역할별 에이전트 1개 (바인딩).
• Slack 채널을 해당 에이전트에 바인딩.
• 필요 시 확장자 릴레이 (또는 노드)를 통해 로컬 브라우저.

​

모델: 기본값, 선택, 별칭, 전환

​

기본 모델은 무엇인가요

agents.defaults.model.primary

​

어떤 모델을 추천하나요

​

직접 호스팅된 모델 llamacpp vLLM Ollama를 사용할 수 있나요

​

설정을 초기화하지 않고 모델을 전환하려면 어떻게 하나요

• 채팅에서 /model (빠르고, 세션별)
• openclaw models set ... (모델 설정만 업데이트)
• openclaw configure --section model (대화형)
• ~/.openclaw/openclaw.json 안의 agents.defaults.model 편집

​

OpenClaw, Flawd, Krill은 어떤 모델을 사용하나요

• OpenClaw + Flawd: Anthropic Opus (anthropic/claude-opus-4-6) - Anthropic를 참조하세요.
• Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - MiniMax를 참조하세요.

​

재시작 없이 모델을 동적으로 전환하는 방법은 무엇인가요

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/model 3

/model opus@anthropic:default
/model opus@anthropic:work

​

프로필을 설정할 때 설정한 프로필을 어떻게 해제할 수 있나요

/model anthropic/claude-opus-4-6

​

일상적인 작업에는 GPT 5.2를 사용하고 코딩에는 Codex 5.3를 사용할 수 있나요

• 빠른 전환(세션별): /model gpt-5.2로 일상 작업, /model gpt-5.3-codex로 코딩.
• 기본값 + 전환: agents.defaults.model.primary를 openai/gpt-5.2로 설정한 뒤 코딩 시 openai-codex/gpt-5.3-codex로 전환 (또는 그 반대).
• 하위 에이전트: 코딩 작업을 다른 기본 모델로 하위 에이전트에 라우팅.

​

모델이 허용되지 않았다는 메시지가 나타난 이후 응답이 없는 이유는 무엇인가요

모델 "provider/model"은 허용되지 않습니다. 사용 가능한 모델은 /model로 나열하십시오.

​

Unknown model minimaxMiniMaxM21라는 오류가 왜 나타나나요

1. 2026.1.12로 업그레이드 (또는 소스 main으로 실행), 그런 다음 게이트웨이를 재시작합니다.
2. MiniMax가 구성되어 있는지 확인하세요 (마법사나 JSON), 또는 MiniMax API 키가 env/auth 프로필에 존재하여 프로바이더가 주입될 수 있어야 합니다.
3. 정확한 모델 ID를 사용하세요 (대소문자 구별): minimax/MiniMax-M2.1 또는 minimax/MiniMax-M2.1-lightning.
4. 다음을 실행하세요:
   복사

   AI에게 묻기

   openclaw models list
   
   목록에서 선택하고 (또는 채팅에서 /model list).

​

MiniMax를 기본값으로 사용하고 복잡한 작업에는 OpenAI를 사용할 수 있나요

{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2.1" },
      models: {
        "minimax/MiniMax-M2.1": { alias: "minimax" },
        "openai/gpt-5.2": { alias: "gpt" },
      },
    },
  },
}

/model gpt

• 에이전트 A 기본값: MiniMax
• 에이전트 B 기본값: OpenAI
• 에이전트별로 라우팅하거나 /agent를 사용하여 전환

​

opus, sonnet, gpt는 내장된 단축어인가요

• opus → anthropic/claude-opus-4-6
• sonnet → anthropic/claude-sonnet-4-5
• gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• gemini-flash → google/gemini-3-flash-preview

​

모델 단축어 별칭을 정의/재정의하는 방법은 무엇인가요

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

​

OpenRouter 또는 ZAI 같은 다른 프로바이더의 모델을 추가하는 방법은 무엇인가요

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." },
}

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• openclaw agents add <id>를 실행하고 마법사 중에 인증을 구성하세요.
• 또는 메인 에이전트의 agentDir에서 새로운 에이전트의 agentDir으로 auth-profiles.json을 복사하세요.

​

모델 대체 및 “모든 모델 실패”

​

대체는 어떻게 작동하나요

1. 동일한 프로바이더 내에서의 인증 프로필 회전.
2. agents.defaults.model.fallbacks의 다음 모델로 모델 대체.

​

이 오류는 무엇을 의미하나요

No credentials found for profile "anthropic:default"

​

No credentials found for profile anthropicdefault에 대한 수정 체크리스트

• 인증 프로필 위치 확인 (새 vs 레거시 경로)
  • 현재: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • 레거시: ~/.openclaw/agent/* (openclaw doctor에 의해 마이그레이션)
• 게이트웨이에서 env var이 로드되었는지 확인
  • 쉘에 ANTHROPIC_API_KEY를 설정했지만 게이트웨이를 systemd/launchd를 통해 실행하는 경우, 이를 상속하지 않을 수 있습니다. ~/.openclaw/.env에 넣거나 env.shellEnv를 활성화하세요.
• 올바른 에이전트를 편집하고 있는지 확인
  • 다중 에이전트 설정의 경우 여러 auth-profiles.json 파일이 존재할 수 있습니다.
• 모델/인증 상태의 무결성 검사
  • openclaw models status를 사용하여 구성된 모델과 프로바이더가 인증되었는지 확인하세요.

• 설정 토큰을 사용하세요
  • claude setup-token를 실행한 다음 openclaw models auth setup-token --provider anthropic으로 붙여넣으세요.
  • 다른 머신에서 토큰이 생성된 경우, openclaw models auth paste-token --provider anthropic을 사용하세요.
• API 키를 대신 사용하고 싶으시다면
  • ANTHROPIC_API_KEY를 게이트웨이 호스트의 ~/.openclaw/.env에 넣으세요.
  • 누락된 프로필을 강제하는 고정 순서를 지우세요:
    복사

    AI에게 묻기

    openclaw models auth order clear --provider anthropic
    
• 게이트웨이 호스트에서 명령을 실행 중인지 확인
  • 원격 모드에서는 인증 프로필이 게이트웨이 머신에 존재하며, 본인의 랩탑에 있지 않습니다.

​

왜 Google Gemini도 시도했고 실패했나요

​

인증 프로필: 정의와 관리 방법

​

인증 프로필이란 무엇인가

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

일반적인 프로필 ID는 무엇인가요

• anthropic:default (이메일 아이덴티티가 없을 때 일반적)
• anthropic:<email> OAuth 아이덴티티
• 사용자가 선택한 사용자 지정 ID (예: anthropic:work)

​

어떤 인증 프로필을 먼저 시도할지 제어할 수 있나요

# 구성된 기본 에이전트로 기본 설정 ( --agent 생략)
openclaw models auth order get --provider anthropic

# 회전을 단일 프로필로 고정 (이것만 시도)
openclaw models auth order set --provider anthropic anthropic:default

# 또는 명시적인 순서를 설정함 (프로바이더 내에서 대체)
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# 재정의 지우기 (구성 auth.order / 라운드 로빈으로 돌아가기)
openclaw models auth order clear --provider anthropic

openclaw models auth order set --provider anthropic --agent main anthropic:default

​

OAuth와 API 키의 차이점은 무엇인가요

• OAuth는 종종 구독 액세스를 활용합니다 (가능한 경우).
• API 키는 사용한 만큼 비용을 청구합니다.

​

게이트웨이: 포트 설정, “이미 실행 중” 문제, 원격 모드

​

게이트웨이는 어떤 포트를 사용하나요

--port > OPENCLAW_GATEWAY_PORT > gateway.port > 기본값 18789

​

openclaw 게이트웨이 상태가 런타임이 실행 중이라고 하면서 RPC 프로브가 실패하는 이유는 무엇인가요

• Probe target: (실제로 프로브가 사용한 URL)
• Listening: (포트에 실제로 바인딩된 것)
• Last gateway error: (프로세스는 살아 있지만 포트가 연결되지 않은 일의 일반적인 원인)

​

왜 openclaw 게이트웨이 상태가 구성된 CLI와 구성된 서비스가 다르다고 하나요

openclaw gateway install --force

​

”다른 게이트웨이 인스턴스가 이미 수신 대기 중”이라는 메시지가 나오는 이유는 무엇인가요

​

OpenClaw를 원격 모드로 실행하려면 어떻게 해야 하나요

{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}

• openclaw gateway는 gateway.mode가 local일 때만 시작됩니다 (또는 재정의 플래그를 전달할 때).
• macOS 앱은 구성 파일을 감시하며 이 값이 변경될 때 모드를 실시간으로 전환합니다.

​

컨트롤 UI에서 “권한 없음”이라고 표시되거나 계속 재연결하는 경우 어떻게 해야 하나요

• 컨트롤 UI는 토큰을 브라우저의 localStorage 키 openclaw.control.settings.v1에 저장합니다.

• 가장 빠른 방법: openclaw dashboard (대시보드 URL을 출력 + 복사, 열기를 시도; 헤드리스일 경우 SSH 힌트 표시).
• 아직 토큰이 없는 경우: openclaw doctor --generate-gateway-token.
• 원격인 경우, 먼저 터널을 엽니다: ssh -N -L 18789:127.0.0.1:18789 user@host 그런 다음 http://127.0.0.1:18789/를 엽니다.
• 게이트웨이 호스트에 gateway.auth.token (또는 OPENCLAW_GATEWAY_TOKEN)을 설정합니다.
• 컨트롤 UI 설정에 동일한 토큰을 붙여넣습니다.
• 여전히 해결되지 않나요? openclaw status --all을 실행하고 문제 해결을 참조하세요. 인증 세부 정보는 대시보드를 확인하세요.

​

gatewaybind tailnet을 설정했지만 바인딩할 수 없거나 수신 대기하는 것이 없는 이유는 무엇인가요

• 해당 호스트에서 Tailscale을 시작합니다 (그래서 100.x 주소를 가집니다), 또는
• gateway.bind: "loopback" / "lan"으로 전환하세요.

​

같은 호스트에서 여러 게이트웨이를 실행할 수 있나요

• OPENCLAW_CONFIG_PATH (인스턴스별 구성)
• OPENCLAW_STATE_DIR (인스턴스별 상태)
• agents.defaults.workspace (작업공간 격리)
• gateway.port (고유한 포트)

• 인스턴스당 openclaw --profile <name> …을 사용하세요 (자동으로 ~/.openclaw-<name>을 만듭니다).
• 각 프로필 구성에서 고유한 gateway.port를 설정하거나 수동 실행을 위해 --port를 전달하세요.
• 프로필별 서비스를 설치합니다: openclaw --profile <name> gateway install.

​

”Invalid handshake code 1008”은 무슨 의미인가요

• 브라우저에서 HTTP URL을 열었습니다 (http://...) 대신 WS 클라이언트를 사용했습니다.
• 잘못된 포트 또는 경로를 사용했습니다.
• 프록시 또는 터널이 인증 헤더를 제거하거나 게이트웨이가 아닌 요청을 보냈습니다.

1. WS URL을 사용하세요: ws://<host>:18789 (또는 HTTPS일 경우 wss://...).
2. 일반 브라우저 탭에서 WS 포트를 열지 마세요.
3. 인증이 켜져있다면 connect 프레임에 토큰/비밀번호를 포함시키세요.

openclaw tui --url ws://<host>:18789 --token <token>

​

로깅 및 디버깅

​

로그는 어디에 있나요

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS: $OPENCLAW_STATE_DIR/logs/gateway.log 및 gateway.err.log (기본값: ~/.openclaw/logs/...; 프로필은 ~/.openclaw-<profile>/logs/... 사용)
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

​

게이트웨이 서비스를 시작/중지/재시작하려면

openclaw gateway status
openclaw gateway restart

​

Windows에서 터미널을 닫았는데 OpenClaw를 재시작하려면 어떻게 해야 하나요

wsl
openclaw gateway status
openclaw gateway restart

openclaw gateway run

openclaw gateway status
openclaw gateway restart

openclaw gateway run

​

게이트웨이가 실행 중인데 응답이 오지 않습니다. 무엇을 확인해야 하나요

openclaw status
openclaw models status
openclaw channels status
openclaw logs --follow

• 모델 인증이 게이트웨이 호스트에서 로드되지 않음 (예: models status 확인).
• 채널 페어링/허용리스트가 응답을 차단 (채널 구성 및 로그 확인).
• WebChat/대시보드가 올바른 토큰 없이 열려 있음.

​

”게이트웨이에서 이유 없이 연결이 끊어짐” - 다음 단계는

1. 게이트웨이가 실행 중인가요? openclaw gateway status
2. 게이트웨이가 정상인가요? openclaw status
3. UI에 올바른 토큰이 있나요? openclaw dashboard
4. 원격일 경우 터널/Tailscale 링크가 활성화되었나요?

openclaw logs --follow

​

Telegram setMyCommands에서 네트워크 오류가 발생합니다. 무엇을 확인해야 하나요

openclaw channels status
openclaw channels logs --channel telegram

​

TUI에 출력이 없습니다. 무엇을 확인해야 하나요

openclaw status
openclaw models status
openclaw logs --follow

​

게이트웨이를 완전히 중지한 다음 다시 시작하려면

openclaw gateway stop
openclaw gateway start

openclaw gateway run

​

ELI5 openclaw gateway restart와 openclaw gateway의 차이점은

• openclaw gateway restart: 백그라운드 서비스 (launchd/systemd)를 재시작합니다.
• openclaw gateway: 이 터미널 세션에 대해 게이트웨이를 전경에서 실행합니다.

​

문제가 발생하면 가장 빨리 추가 정보를 얻는 방법은 무엇인가요

​

미디어 및 첨부 파일

​

내 스킬이 이미지/PDF를 생성했지만 아무 것도 전송되지 않았습니다

openclaw message send --target +15555550123 --message "여기 있어요" --media /path/to/file.png

• 대상 채널이 아웃바운드 미디어를 지원하고 허용리스트로 차단되지 않은 상태입니다.
• 파일이 프로바이더의 크기 제한 내에 있습니다 (이미지는 최대 2048px로 크기를 조정합니다).

​

보안 및 액세스 제어

​

OpenClaw를 들어오는 다이렉트 메시지에 노출하는 것이 안전한가요

• DM 가능한 채널의 기본 동작은 페어링입니다:
  • 알려지지 않은 보낸 사람은 페어링 코드를 받으며, 봇은 메시지를 처리하지 않습니다.
  • 승인 방법: openclaw pairing approve <channel> <code>
  • 보류 중인 요청은 채널당 3개로 제한됩니다; 코드가 도착하지 않으면 openclaw pairing list <channel>를 확인하세요.
• 공개적으로 다이렉트 메시지를 열려면 명시적인 동의가 필요합니다 (dmPolicy: "open" 및 허용리스트에 "*").

​

프롬프트 주입은 공개 봇의 경우에만 문제가 되나요

• 신뢰할 수 없는 콘텐츠를 요약하기 위해 읽기 전용 또는 도구가 비활성화된 “읽기” 에이전트를 사용하는 것
• web_search / web_fetch / browser를 도구가 활성화된 에이전트에 대해 꺼두기
• 샌드박스 격리 및 엄격한 도구 허용리스트 사용

​

내 봇에게 자체 이메일, GitHub 계정 또는 전화번호를 가져야 하나요

​

개인 메시지에 대한 자율권을 부여할 수 있고, 안전한가요

• 다이렉트 메시지를 페어링 모드 또는 엄격한 허용리스트로 유지하세요.
• 만약 당신을 대신하여 메시지를 전달하길 원한다면, 두 번째 전화번호나 계정을 사용하세요.
• 초안을 작성하게 하고, 전송하기 전에 승인하세요.

​

개인 비서 작업에 더 저렴한 모델을 사용할 수 있나요

​

Telegram에서 시작 명령을 실행했지만 페어링 코드를 받지 못했습니다

openclaw pairing list telegram

​

WhatsApp에서는 내 연락처에 메시지를 보낼까요? 페어링은 어떻게 작동하나요

openclaw pairing approve whatsapp <code>

openclaw pairing list whatsapp

​

채팅 명령어, 작업 중단, 및 “멈추지 않음”

​

채팅에서 내부 시스템 메시지가 표시되지 않도록 하려면

/verbose off
/reasoning off

​

실행 중인 작업을 중지/취소하려면

stop
abort
esc
wait
exit
interrupt

process action:kill sessionId:XXX

​

Telegram에서 Discord 메시지를 보내려고 할 때 크로스컨텍스트 메시징이 거부됩니다

{
  agents: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true,
            marker: { enabled: true, prefix: "[from {channel}] " },
          },
        },
      },
    },
  },
}

​

봇이 빠르게 오는 메시지를 무시하는 것처럼 느껴지는 이유는 무엇인가요

• steer - 새 메시지가 현재 작업을 재지정합니다
• followup - 메시지를 한 번에 한 개씩 실행
• collect - 메시지를 일괄 처리하고 한 번에 응답 (기본값)
• steer-backlog - 지금 재지정, 그런 다음 백로그 처리
• interrupt - 현재 실행을 중단하고 새로 시작

​

스크린샷/채팅 로그에서 정확한 질문에 답변하기