문제가 발생했을 때 먼저 확인할 60초 절차
빠른 상태 확인
붙여넣을 수 있는 보고서(안전하게 공유 가능)
데몬 및 포트 상태
심층 프로브
doctor 실행(복구)
Gateway 스냅샷(WS 전용)
빠른 시작 및 최초 실행 설정
설치, 온보딩, 인증 경로, 구독, 초기 오류에 관한 최초 실행 Q&A는 최초 실행 FAQ에 있습니다.OpenClaw란 무엇인가요?
OpenClaw를 한 문단으로 설명하면 무엇인가요?
OpenClaw를 한 문단으로 설명하면 무엇인가요?
가치 제안
가치 제안
- 사용자의 기기와 데이터: 원하는 위치(Mac, Linux, VPS)에서 Gateway를 실행하고 워크스페이스와 세션 기록을 로컬에 보관합니다.
- 웹 샌드박스가 아닌 실제 채널: Discord/iMessage/Signal/Slack/Telegram/WhatsApp 등을 지원하며, 지원되는 플랫폼에서는 모바일 음성과 Canvas도 제공합니다.
- 모델 독립적: Anthropic, MiniMax, OpenAI, OpenRouter 등을 에이전트별 라우팅 및 장애 조치와 함께 사용할 수 있습니다.
- 로컬 전용 옵션: 로컬 모델을 실행하여 모든 데이터를 기기에 보관할 수 있습니다.
- 다중 에이전트 라우팅: 채널, 계정 또는 작업별로 에이전트를 분리하고 각각 자체 워크스페이스와 기본값을 사용하도록 설정할 수 있습니다.
- 오픈 소스이며 자유롭게 수정 가능: 공급업체 종속 없이 검사하고 확장하며 자체 호스팅할 수 있습니다.
방금 설정을 마쳤습니다. 먼저 무엇을 해야 하나요?
방금 설정을 마쳤습니다. 먼저 무엇을 해야 하나요?
OpenClaw의 대표적인 일상 활용 사례 다섯 가지는 무엇인가요?
OpenClaw의 대표적인 일상 활용 사례 다섯 가지는 무엇인가요?
- 개인 브리핑: 받은편지함, 일정 및 관심 있는 뉴스의 요약을 제공합니다.
- 조사 및 초안 작성: 이메일이나 문서를 위한 빠른 조사, 요약 및 초안을 작성합니다.
- 알림 및 후속 작업: Cron 또는 Heartbeat 기반 알림과 체크리스트를 제공합니다.
- 브라우저 자동화: 양식 작성, 데이터 수집 및 반복적인 웹 작업을 수행합니다.
- 기기 간 조정: 휴대폰에서 작업을 보내고, 서버의 Gateway가 작업을 실행하도록 한 다음, 채팅으로 결과를 돌려받습니다.
OpenClaw가 SaaS의 잠재 고객 발굴, 아웃리치, 광고 및 블로그 작업을 지원할 수 있나요?
OpenClaw가 SaaS의 잠재 고객 발굴, 아웃리치, 광고 및 블로그 작업을 지원할 수 있나요?
웹 개발에서 Claude Code와 비교했을 때 어떤 장점이 있나요?
웹 개발에서 Claude Code와 비교했을 때 어떤 장점이 있나요?
- 세션 간 지속되는 메모리와 워크스페이스.
- 다중 플랫폼 접근(Telegram, WhatsApp, TUI, WebChat).
- 도구 오케스트레이션(브라우저, 파일, 일정 예약, 훅).
- 항상 실행되는 Gateway(VPS에서 실행하고 어디서나 상호작용).
- 로컬 브라우저/화면/카메라/명령 실행을 위한 Node.
Skills 및 자동화
저장소를 변경된 상태로 유지하지 않고 Skills를 사용자 지정하려면 어떻게 해야 하나요?
저장소를 변경된 상태로 유지하지 않고 Skills를 사용자 지정하려면 어떻게 해야 하나요?
~/.openclaw/skills/<name>/SKILL.md에 넣거나 ~/.openclaw/openclaw.json의 skills.load.extraDirs를 통해 폴더를 추가하십시오. 우선순위는 <workspace>/skills -> <workspace>/.agents/skills -> ~/.agents/skills -> ~/.openclaw/skills -> 번들 항목 -> skills.load.extraDirs 순이므로, git을 건드리지 않고도 관리형 재정의가 번들 Skills보다 우선합니다. 전역으로 설치하되 일부 에이전트에만 표시하려면 공유 복사본을 ~/.openclaw/skills에 두고 agents.defaults.skills / agents.list[].skills로 표시 범위를 제어하십시오. 업스트림에 반영할 가치가 있는 편집만 저장소 복사본을 대상으로 PR을 제출해야 합니다.사용자 지정 폴더에서 Skills를 로드할 수 있나요?
사용자 지정 폴더에서 Skills를 로드할 수 있나요?
~/.openclaw/openclaw.json의 skills.load.extraDirs를 통해 디렉터리를 추가하십시오(위 순서에서 우선순위가 가장 낮음). clawhub는 기본적으로 ./skills에 설치하며, OpenClaw는 다음 세션에서 이를 <workspace>/skills로 처리합니다. 특정 에이전트에만 표시하려면 agents.defaults.skills 또는 agents.list[].skills와 함께 사용하십시오.작업별로 서로 다른 모델이나 설정을 사용하려면 어떻게 해야 하나요?
작업별로 서로 다른 모델이나 설정을 사용하려면 어떻게 해야 하나요?
- Cron 작업: 격리된 작업마다
model재정의를 설정할 수 있습니다. - 에이전트: 기본 모델, 사고 수준 및 스트림 매개변수가 서로 다른 별도 에이전트로 작업을 라우팅할 수 있습니다.
- 요청 시 전환:
/model을 사용하여 언제든지 현재 세션 모델을 전환할 수 있습니다.
agents.defaults.models["provider/model"].params에 넣고, 에이전트별 재정의는 평면 구조의 agents.list[].params에 넣으십시오. 중첩된 agents.list[].models["provider/model"].params 아래에 동일한 모델을 중복으로 넣지 마십시오. 해당 경로는 에이전트별 모델 카탈로그 및 런타임 재정의용입니다.Cron 작업, 다중 에이전트 라우팅, 구성, 슬래시 명령을 참조하십시오.과도한 작업을 수행하는 동안 봇이 멈춥니다. 이 작업을 어떻게 분산할 수 있나요?
과도한 작업을 수행하는 동안 봇이 멈춥니다. 이 작업을 어떻게 분산할 수 있나요?
/subagents를 사용하십시오. Gateway가 현재 작업 중인지 확인하려면 /status를 사용하십시오.장시간 작업과 하위 에이전트 모두 토큰을 소비합니다. 비용이 중요하다면 agents.defaults.subagents.model을 통해 하위 에이전트에 더 저렴한 모델을 설정하십시오.문서: 하위 에이전트, 백그라운드 작업.Discord에서 스레드에 바인딩된 하위 에이전트 세션은 어떻게 작동하나요?
Discord에서 스레드에 바인딩된 하위 에이전트 세션은 어떻게 작동하나요?
thread: true를 사용하여sessions_spawn으로 생성하십시오(지속적인 후속 작업에는 선택적으로mode: "session"사용).- 또는
/focus <target>을 사용하여 수동으로 바인딩하십시오. /agents로 바인딩 상태를 확인합니다./session idle <duration|off>및/session max-age <duration|off>로 자동 포커스 해제를 제어합니다./unfocus로 스레드 연결을 해제합니다.
session.threadBindings.enabled(전역 스위치), session.threadBindings.idleHours(기본값 24, 0은 비활성화), session.threadBindings.maxAgeHours(기본값 0 = 최대 제한 없음), 채널별 재정의 channels.discord.threadBindings.{enabled,idleHours,maxAgeHours}. channels.discord.threadBindings.spawnSessions는 생성 시 자동 바인딩 여부를 제어합니다(기본값 true).문서: 하위 에이전트, Discord, 구성 레퍼런스, 슬래시 명령.하위 에이전트가 완료되었지만 완료 업데이트가 잘못된 위치로 전송되었거나 게시되지 않았습니다. 무엇을 확인해야 하나요?
하위 에이전트가 완료되었지만 완료 업데이트가 잘못된 위치로 전송되었거나 게시되지 않았습니다. 무엇을 확인해야 하나요?
- 완료 모드의 하위 에이전트 전달은 바인딩된 스레드나 대화 경로가 있으면 이를 우선합니다.
- 완료 작업의 출처에 채널 정보만 있는 경우에도 직접 전달이 성공할 수 있도록 OpenClaw는 요청자 세션에 저장된 경로(
lastChannel/lastTo/lastAccountId)를 대신 사용합니다. - 바인딩된 경로도 없고 사용할 수 있는 저장 경로도 없으면 직접 전달이 실패할 수 있으며, 결과는 즉시 게시되지 않고 대기 중인 세션 전달로 전환됩니다.
- 유효하지 않거나 오래된 대상도 대기열 전환 또는 최종 전달 실패를 유발할 수 있습니다.
- 하위 에이전트의 마지막으로 표시된 어시스턴트 응답이 정확히
NO_REPLY/no_reply또는ANNOUNCE_SKIP이면 OpenClaw는 이전의 오래된 진행 상황을 게시하지 않고 의도적으로 알림을 생략합니다.
<lookup>이 작업 ID, 실행 ID 또는 세션 키인 경우 openclaw tasks show <lookup>을 사용하십시오.문서: 하위 에이전트, 백그라운드 작업, 세션 도구.Cron 또는 알림이 실행되지 않습니다. 무엇을 확인해야 하나요?
Cron 또는 알림이 실행되지 않습니다. 무엇을 확인해야 하나요?
Cron이 실행되었지만 채널로 아무것도 전송되지 않았습니다. 이유가 무엇인가요?
Cron이 실행되었지만 채널로 아무것도 전송되지 않았습니다. 이유가 무엇인가요?
--no-deliver/delivery.mode: "none": 러너의 폴백 전송이 실행되지 않는 것이 정상입니다.- 알림 대상(
channel/to)이 없거나 유효하지 않음: 러너가 외부 전달을 건너뛰었습니다. - 채널 인증 실패(
unauthorized,Forbidden): 러너가 전달을 시도했지만 자격 증명으로 인해 차단되었습니다. - 무응답 격리 결과(
NO_REPLY/no_reply만 해당)는 의도적으로 전달할 수 없는 것으로 처리되므로, 대기열의 폴백 전달도 억제됩니다.
message 도구를 사용하여 직접 전송할 수 있습니다. --announce는 에이전트가 자체적으로 아직 전송하지 않은 최종 텍스트에 대한 러너의 폴백 전달만 제어합니다.디버그:격리된 Cron 실행이 모델을 전환하거나 한 번 재시도한 이유는 무엇인가요?
격리된 Cron 실행이 모델을 전환하거나 한 번 재시도한 이유는 무엇인가요?
LiveSessionModelSwitchError가 발생하면 전환된 공급자/모델과 전환된 인증 프로필 재정의가 있다면 이를 유지한 후 재시도합니다.모델 선택 우선순위: 먼저 Gmail 훅 모델 재정의(hooks.gmail.model), 그다음 작업별 model, 저장된 Cron 세션 모델 재정의, 마지막으로 일반 에이전트/기본 모델 선택 순입니다.재시도 루프는 최초 시도와 2회의 전환 재시도로 제한되며, 이후 Cron은 무한 반복하는 대신 중단됩니다.디버그:Linux에서 Skills를 설치하려면 어떻게 하나요?
Linux에서 Skills를 설치하려면 어떻게 하나요?
openclaw skills 명령을 사용하거나 Skills를 워크스페이스에 추가하십시오. macOS Skills UI는 Linux에서 사용할 수 없습니다. https://clawhub.ai에서 Skills를 살펴볼 수 있습니다.openclaw skills install은 기본적으로 활성 워크스페이스의 skills/ 디렉터리에 기록합니다. 모든 로컬 에이전트가 사용하는 공유 관리형 Skills 디렉터리에 설치하려면 --global을 추가하십시오. 별도의 clawhub CLI는 자체 Skills를 게시하거나 동기화할 때만 설치하십시오. 공유 Skills를 볼 수 있는 에이전트를 제한하려면 agents.defaults.skills 또는 agents.list[].skills를 사용하십시오.OpenClaw가 일정에 따라 또는 백그라운드에서 지속적으로 작업을 실행할 수 있나요?
OpenClaw가 일정에 따라 또는 백그라운드에서 지속적으로 작업을 실행할 수 있나요?
Linux에서 Apple macOS 전용 Skills를 실행할 수 있나요?
Linux에서 Apple macOS 전용 Skills를 실행할 수 있나요?
metadata.openclaw.os와 필수 바이너리를 기준으로 제한되며, Gateway 호스트에서 적격할 때만 로드됩니다. Linux에서는 제한을 재정의하지 않는 한 darwin 전용 Skills(apple-notes, apple-reminders, things-mac)가 로드되지 않습니다.지원되는 세 가지 패턴은 다음과 같습니다.옵션 A - Mac에서 Gateway 실행(가장 간단함). macOS 바이너리가 있는 곳에서 Gateway를 실행한 다음, Linux에서 원격 모드 또는 Tailscale을 통해 연결하십시오. Gateway 호스트가 macOS이므로 Skills가 정상적으로 로드됩니다.옵션 B - macOS Node 사용(SSH 불필요). Linux에서 Gateway를 실행하고 macOS Node(메뉴 막대 앱)를 페어링한 후, Mac에서 Node Run Commands를 “Always Ask” 또는 “Always Allow”로 설정하십시오. OpenClaw는 Node에 필수 바이너리가 있으면 macOS 전용 Skills를 적격한 것으로 처리하며, 에이전트는 nodes 도구를 통해 이를 실행합니다. “Always Ask”를 사용하는 경우 프롬프트에서 “Always Allow”를 승인하면 해당 명령이 허용 목록에 추가됩니다.옵션 C - SSH를 통해 macOS 바이너리 프록시(고급). Gateway는 Linux에 유지하되, 필수 CLI 바이너리가 Mac에서 실행되는 SSH 래퍼로 해석되도록 만든 다음, Skill이 적격 상태를 유지하도록 Linux를 허용하는 재정의를 적용하십시오.- 바이너리용 SSH 래퍼를 생성합니다(예: Apple Notes용
memo). - Linux 호스트의
PATH에 래퍼를 추가합니다(예:~/bin/memo). - Linux를 허용하도록 Skill 메타데이터(워크스페이스 또는
~/.openclaw/skills)를 재정의합니다. - Skills 스냅샷이 새로 고쳐지도록 새 세션을 시작합니다.
Notion 또는 HeyGen 통합이 있나요?
Notion 또는 HeyGen 통합이 있나요?
- 사용자 지정 Skill / Plugin: 신뢰할 수 있는 API 액세스에 가장 적합합니다(둘 다 API를 제공합니다).
- 브라우저 자동화: 코드 없이 작동하지만 더 느리고 취약합니다.
skills/ 디렉터리에 저장됩니다. 모든 로컬 에이전트에 적용하려면 --global을 사용하고, 표시 범위를 제한하려면 agents.defaults.skills / agents.list[].skills를 구성하십시오. 일부 Skills에는 Homebrew로 설치한 바이너리가 필요하며, Linux에서는 Linuxbrew를 의미합니다.Skills, Skills 구성, ClawHub을 참조하십시오.기존에 로그인된 Chrome을 OpenClaw에서 사용하려면 어떻게 하나요?
기존에 로그인된 Chrome을 OpenClaw에서 사용하려면 어떻게 하나요?
user 브라우저 프로필을 사용하십시오.openclaw 프로필과 비교한 existing-session / user 프로필의 현재 제한 사항은 다음과 같습니다.click,type,hover,scrollIntoView,drag,select에는 CSS 선택자가 아니라 스냅샷 참조가 필요합니다.- 업로드 훅에는
ref또는inputRef가 필요하고 한 번에 파일 하나만 업로드할 수 있으며 CSSelement는 사용할 수 없습니다. responsebody, PDF 내보내기, 다운로드 가로채기, 일괄 작업에는 여전히 관리형 브라우저 경로가 필요합니다.
샌드박싱 및 메모리
Docker의 기능이 제한적으로 느껴집니다. 전체 기능을 활성화하려면 어떻게 하나요?
Docker의 기능이 제한적으로 느껴집니다. 전체 기능을 활성화하려면 어떻게 하나요?
node 사용자로 실행되므로 시스템 패키지, Homebrew, 번들 브라우저가 제외됩니다. 더 완전한 설정을 구성하려면 다음을 수행하십시오.- 캐시가 유지되도록
OPENCLAW_HOME_VOLUME을 사용하여/home/node를 영구 저장합니다. OPENCLAW_IMAGE_APT_PACKAGES를 사용하여 시스템 종속성을 이미지에 포함합니다.- 번들 CLI를 통해 Playwright 브라우저를 설치합니다:
node /app/node_modules/playwright-core/cli.js install chromium. PLAYWRIGHT_BROWSERS_PATH를 설정하고 해당 경로를 영구 저장합니다.
하나의 에이전트에서 DM은 비공개로 유지하고 그룹은 공개/샌드박스화할 수 있나요?
하나의 에이전트에서 DM은 비공개로 유지하고 그룹은 공개/샌드박스화할 수 있나요?
agents.defaults.sandbox.mode: "non-main"으로 설정하면 그룹/채널 세션(기본 세션이 아닌 키)은 구성된 샌드박스 백엔드에서 실행되고 기본 DM 세션은 호스트에서 계속 실행됩니다. 샌드박싱을 활성화하면 Docker가 기본 백엔드입니다. tools.sandbox.tools를 통해 샌드박스화된 세션에서 사용할 수 있는 도구를 제한하십시오.설정 안내: 그룹: 개인 DM + 공개 그룹. 주요 참조: Gateway 구성.메모리는 어떻게 작동하나요?
메모리는 어떻게 작동하나요?
memory/YYYY-MM-DD.md에, 선별된 장기 메모는 MEMORY.md에 저장됩니다(기본/비공개 세션만 해당).OpenClaw는 Compaction이 대화를 요약하기 전에 자동 Compaction 전 메모리 플러시도 실행하여, 모델이 먼저 영구 메모를 작성하도록 알립니다. 워크스페이스가 쓰기 가능한 경우에만 실행되며 읽기 전용 샌드박스에서는 건너뜁니다. 비활성화하려면 agents.defaults.compaction.memoryFlush.enabled: false를 사용하십시오. 메모리를 참조하십시오.메모리가 계속 내용을 잊습니다. 기억하게 하려면 어떻게 하나요?
메모리가 계속 내용을 잊습니다. 기억하게 하려면 어떻게 하나요?
MEMORY.md에, 단기 컨텍스트는 memory/YYYY-MM-DD.md에 저장됩니다. 모델에 메모리를 저장하라고 상기시키면 일반적으로 문제가 해결됩니다. 계속 잊는다면 Gateway가 실행할 때마다 동일한 워크스페이스를 사용하는지 확인하십시오.문서: 메모리, 에이전트 워크스페이스.메모리는 영구적으로 유지되나요? 제한은 무엇인가요?
메모리는 영구적으로 유지되나요? 제한은 무엇인가요?
의미 기반 메모리 검색에 OpenAI API 키가 필요한가요?
의미 기반 메모리 검색에 OpenAI API 키가 필요한가요?
OPENAI_API_KEY 또는 models.providers.openai.apiKey)가 필요합니다.로컬에서만 유지하려면 agents.defaults.memorySearch.provider: "local"(GGUF/llama.cpp)을 설정하십시오. 그 밖에 지원되는 공급자는 Bedrock, DeepInfra, Gemini(GEMINI_API_KEY 또는 memorySearch.remote.apiKey), GitHub Copilot, LM Studio, Mistral, Ollama, OpenAI 호환 공급자, Voyage입니다. 설정 세부 정보는 메모리 및 메모리 검색을 참조하십시오.디스크에서 항목이 저장되는 위치
OpenClaw에서 사용하는 모든 데이터가 로컬에 저장됩니까?
OpenClaw에서 사용하는 모든 데이터가 로컬에 저장됩니까?
- 기본적으로 로컬: 세션, 메모리 파일, 구성, 워크스페이스는 Gateway 호스트(
~/.openclaw및 워크스페이스 디렉터리)에 있습니다. - 필요에 따라 원격: 모델 공급자(Anthropic/OpenAI 등)로 전송된 메시지는 해당 API로 전달되며, 채팅 플랫폼(Slack/Telegram/WhatsApp 등)은 메시지 데이터를 자체 서버에 저장합니다.
- 사용자가 범위를 제어할 수 있음: 로컬 모델을 사용하면 프롬프트가 사용자 머신에 유지되지만, 채널 트래픽은 여전히 채널 서버를 통과합니다.
OpenClaw는 데이터를 어디에 저장합니까?
OpenClaw는 데이터를 어디에 저장합니까?
$OPENCLAW_STATE_DIR(기본값: ~/.openclaw) 아래에 있습니다.~/.openclaw/agent/*는 openclaw doctor가 마이그레이션합니다.워크스페이스(AGENTS.md, 메모리 파일, Skills 등)는 별도이며 agents.defaults.workspace(기본값: ~/.openclaw/workspace)를 통해 구성합니다.AGENTS.md / SOUL.md / USER.md / MEMORY.md는 어디에 있어야 합니까?
AGENTS.md / SOUL.md / USER.md / MEMORY.md는 어디에 있어야 합니까?
~/.openclaw가 아니라 에이전트 워크스페이스에 있습니다.- 워크스페이스(에이전트별):
AGENTS.md,SOUL.md,IDENTITY.md,USER.md,MEMORY.md,memory/YYYY-MM-DD.md, 선택적HEARTBEAT.md. 루트의 소문자memory.md는 레거시 복구 입력으로만 사용됩니다. 두 파일이 모두 있으면openclaw doctor --fix가 이를MEMORY.md에 병합할 수 있습니다. - 상태 디렉터리(
~/.openclaw): 구성, 채널/공급자 상태, 인증 프로필, 세션, 로그, 공유 Skills(~/.openclaw/skills).
~/.openclaw/workspace이며 다음과 같이 구성할 수 있습니다.SOUL.md를 더 크게 만들 수 있습니까?
SOUL.md를 더 크게 만들 수 있습니까?
SOUL.md는 에이전트 컨텍스트에 주입되는 워크스페이스 부트스트랩 파일 중 하나입니다. 기본 파일별 주입 한도는 20000자이며, 전체 파일의 총 부트스트랩 예산은 60000자입니다.공유 기본값을 변경하십시오.agents.list[].bootstrapMaxChars / bootstrapTotalMaxChars 아래에서 개별 에이전트의 값을 재정의하십시오.원본 크기와 주입된 크기를 비교하고 잘림이 발생했는지 확인하려면 /context를 사용하십시오. SOUL.md에는 말투, 관점, 성격에 관한 내용만 집중해서 작성하고, 운영 규칙은 AGENTS.md에, 지속적으로 유지할 사실은 메모리에 작성하십시오.컨텍스트 및 에이전트 구성을 참조하십시오.권장 백업 전략
권장 백업 전략
~/.openclaw 아래의 항목(자격 증명, 세션, 토큰, 암호화된 비밀 정보 페이로드)은 커밋하지 마십시오. 전체를 복원하려면 워크스페이스와 상태 디렉터리를 별도로 백업하십시오.문서: 에이전트 워크스페이스.OpenClaw를 완전히 제거하려면 어떻게 해야 합니까?
OpenClaw를 완전히 제거하려면 어떻게 해야 합니까?
에이전트가 워크스페이스 외부에서 작업할 수 있습니까?
에이전트가 워크스페이스 외부에서 작업할 수 있습니까?
agents.defaults.sandbox 또는 에이전트별 샌드박스 설정을 사용하십시오. 저장소를 기본 작업 디렉터리로 설정하려면 해당 에이전트의 workspace가 저장소 루트를 가리키도록 하십시오. OpenClaw 저장소 자체는 소스 코드일 뿐이므로, 에이전트가 그 안에서 작업하도록 의도한 경우가 아니라면 워크스페이스를 별도로 유지하십시오.원격 모드: 세션 저장소는 어디에 있습니까?
원격 모드: 세션 저장소는 어디에 있습니까?
구성 기본 사항
구성 형식은 무엇이며 어디에 있습니까?
구성 형식은 무엇이며 어디에 있습니까?
$OPENCLAW_CONFIG_PATH(기본값: ~/.openclaw/openclaw.json)에서 선택적 JSON5 구성을 읽습니다. 파일이 없으면 ~/.openclaw/workspace를 기본 워크스페이스로 사용하는 것을 포함한 비교적 안전한 기본값을 사용합니다.이제 localhost에서도 토큰이 필요한 이유는 무엇입니까?
이제 localhost에서도 토큰이 필요한 이유는 무엇입니까?
gateway.auth.token, gateway.auth.password, OPENCLAW_GATEWAY_TOKEN 또는 OPENCLAW_GATEWAY_PASSWORD를 명시적으로 구성하십시오. 비밀번호 모드나 ID 인식 역방향 프록시용 trusted-proxy를 선택할 수도 있습니다. 인증 없이 루프백을 열려면 gateway.auth.mode: "none"을 명시적으로 설정하십시오. openclaw doctor --generate-gateway-token은 언제든 토큰을 생성합니다.구성을 변경한 후 다시 시작해야 합니까?
구성을 변경한 후 다시 시작해야 합니까?
gateway.reload.mode: "hybrid"(기본값)는 안전한 변경 사항을 즉시 적용하고 중요한 변경 사항이 있으면 다시 시작합니다. hot, restart, off도 지원됩니다. 대부분의 tools.*, agents.* 정책, session.*, messages.* 변경 사항은 리로드 작업 없이 즉시 적용되지만, gateway.* 바인딩/포트 변경 사항은 다시 시작해야 합니다.재미있는 CLI 태그라인을 비활성화하려면 어떻게 해야 합니까?
재미있는 CLI 태그라인을 비활성화하려면 어떻게 해야 합니까?
cli.banner.taglineMode를 설정하십시오.off: 태그라인 텍스트를 숨기지만 배너 제목/버전 줄은 유지합니다.default: 항상All your chats, one OpenClaw.을 사용합니다.random: 재미있거나 계절에 맞는 태그라인을 순환해서 표시합니다(기본 동작).- 배너를 완전히 숨기려면 환경 변수
OPENCLAW_HIDE_BANNER=1을 설정하십시오.
웹 검색(및 웹 가져오기)을 활성화하려면 어떻게 해야 합니까?
웹 검색(및 웹 가져오기)을 활성화하려면 어떻게 해야 합니까?
web_fetch는 API 키 없이 작동합니다. web_search는 선택한 공급자에 따라 다릅니다.openclaw onboard --auth-choice xai-oauth).권장: openclaw configure --section web을 실행하고 공급자를 선택하십시오.plugins.entries.<plugin>.config.webSearch.*에 있습니다. 레거시 tools.web.search.* 공급자 경로도 호환성을 위해 계속 로드되지만 새 구성에서는 사용하지 않아야 합니다. Firecrawl 웹 가져오기 폴백 구성은 plugins.entries.firecrawl.config.webFetch.*에 있습니다.- 허용 목록:
web_search/web_fetch/x_search를 추가하거나, 세 가지 모두를 사용하려면group:web을 추가하십시오. web_fetch는 기본적으로 활성화되어 있습니다.tools.web.fetch.provider를 생략하면 OpenClaw는 사용 가능한 자격 증명에서 준비된 첫 번째 가져오기 폴백 제공자를 자동으로 감지하며, 공식 Firecrawl Plugin이 해당 폴백을 제공합니다.- 데몬은
~/.openclaw/.env(또는 서비스 환경)에서 환경 변수를 읽습니다.
config.apply가 구성을 지웠습니다. 어떻게 복구하고 이를 방지할 수 있나요?
config.apply가 구성을 지웠습니다. 어떻게 복구하고 이를 방지할 수 있나요?
config.apply는 전체 구성을 대체하므로, 일부만 포함된 객체를 적용하면 나머지는 모두 제거됩니다.현재 OpenClaw는 대부분의 우발적인 덮어쓰기를 방지합니다.- OpenClaw가 수행하는 구성 쓰기는 쓰기 전에 변경 후의 전체 구성을 검증합니다.
- 유효하지 않거나 파괴적인 OpenClaw 구성 쓰기는 거부되며
openclaw.json.rejected.*로 저장됩니다. - 직접 편집한 내용으로 인해 시작 또는 핫 리로드가 중단되면 Gateway는 안전하게 실패하거나 리로드를 건너뛰며,
openclaw.json을 다시 작성하지 않습니다. openclaw doctor --fix가 복구를 담당하며, 마지막으로 정상 작동한 구성을 복원하고 거부된 파일을openclaw.json.clobbered.*로 저장할 수 있습니다.
openclaw logs --follow에서Invalid config at,Config write rejected:, 또는config reload skipped (invalid config)를 확인하십시오.- 활성 구성 옆에서 가장 최근의
openclaw.json.clobbered.*또는openclaw.json.rejected.*를 검사하십시오. openclaw config validate및openclaw doctor --fix를 실행하십시오.- 의도한 키만
openclaw config set또는config.patch를 사용하여 다시 복사하십시오. - 마지막으로 정상 작동한 구성이나 거부된 페이로드가 없는 경우: 백업에서 복원하거나
openclaw doctor를 다시 실행한 후 채널/모델을 재구성하십시오. - 예기치 않은 손실이 발생한 경우: 마지막으로 알려진 구성이나 백업을 첨부하여 버그를 신고하십시오. 로컬 코딩 에이전트는 로그나 기록에서 작동하는 구성을 복원할 수 있는 경우가 많습니다.
openclaw config set, 대화형 편집에는 openclaw configure, 익숙하지 않은 경로를 검사하려면 config.schema.lookup(얕은 스키마 노드와 직계 하위 항목 요약을 반환), 부분 RPC 편집에는 config.patch를 사용하고, config.apply는 전체 구성 교체용으로만 사용하십시오. 에이전트용 gateway 런타임 도구는 레거시 tools.bash.* 별칭을 통해서도 tools.exec.ask / tools.exec.security를 다시 작성하지 않습니다.문서: 구성, 구성하기, Gateway 문제 해결, Doctor.여러 기기에서 특화된 워커를 사용하는 중앙 Gateway를 어떻게 실행합니까?
여러 기기에서 특화된 워커를 사용하는 중앙 Gateway를 어떻게 실행합니까?
- Gateway(중앙): 채널(Signal/WhatsApp), 라우팅, 세션을 관리합니다.
- 노드(기기): Mac/iOS/Android가 주변 장치로 연결되어 로컬 도구(
system.run,canvas,camera)를 제공합니다. - 에이전트(워커): 특수 역할(예: 운영 데이터와 개인 데이터)을 위한 별도의 두뇌/워크스페이스입니다.
- 하위 에이전트: 병렬 처리를 위해 기본 에이전트에서 백그라운드 작업을 생성합니다.
- TUI: Gateway에 연결하고 에이전트/세션을 전환합니다.
OpenClaw 브라우저를 헤드리스로 실행할 수 있나요?
OpenClaw 브라우저를 헤드리스로 실행할 수 있나요?
false(헤드풀)입니다. 헤드리스 모드는 일부 사이트에서 봇 방지 검사를 유발할 가능성이 더 높습니다(X/Twitter는 헤드리스 세션을 차단하는 경우가 많습니다). 동일한 Chromium 엔진을 사용하며 대부분의 자동화에서 작동합니다. 주된 차이점은 표시되는 브라우저 창이 없다는 것입니다(시각적 확인에는 스크린샷을 사용하십시오). 브라우저를 참조하십시오.브라우저 제어에 Brave를 사용하려면 어떻게 해야 하나요?
브라우저 제어에 Brave를 사용하려면 어떻게 해야 하나요?
browser.executablePath를 Brave 바이너리(또는 Chromium 기반 브라우저)로 설정하고 Gateway를 다시 시작하십시오. 브라우저를 참조하십시오.원격 Gateway 및 Node
Telegram, Gateway, Node 간에 명령이 어떻게 전달되나요?
Telegram, Gateway, Node 간에 명령이 어떻게 전달되나요?
node.* -> Node -> Gateway -> TelegramNode는 수신되는 제공자 트래픽을 볼 수 없으며, Node RPC 호출만 수신합니다.Gateway가 원격으로 호스팅되는 경우 에이전트가 내 컴퓨터에 어떻게 접근할 수 있나요?
Gateway가 원격으로 호스팅되는 경우 에이전트가 내 컴퓨터에 어떻게 접근할 수 있나요?
node.* 도구(화면, 카메라, 시스템)를 호출할 수 있습니다.- 상시 실행 호스트(VPS/홈 서버)에서 Gateway를 실행합니다.
- Gateway 호스트와 컴퓨터를 동일한 tailnet에 연결합니다.
- Gateway WS에 연결할 수 있는지 확인합니다(tailnet 바인딩 또는 SSH 터널).
- 로컬에서 macOS 앱을 열고 Remote over SSH 모드(또는 직접 tailnet 연결)로 접속하여 Node로 등록되도록 합니다.
- Node를 승인합니다.
system.run을 사용할 수 있습니다. 신뢰하는 장치만 페어링하고 보안을 검토하십시오.문서: Node, Gateway 프로토콜, macOS 원격 모드, 보안.Tailscale이 연결되어 있지만 응답이 없습니다. 어떻게 해야 하나요?
Tailscale이 연결되어 있지만 응답이 없습니다. 어떻게 해야 하나요?
두 OpenClaw 인스턴스가 서로 통신할 수 있나요(로컬 + VPS)?
두 OpenClaw 인스턴스가 서로 통신할 수 있나요(로컬 + VPS)?
openclaw agent --message ... --deliver를 사용하여 다른 Gateway를 호출하는 스크립트를 실행하십시오. 한 봇이 원격 VPS에 있는 경우 SSH/Tailscale을 통해 CLI가 해당 원격 Gateway를 가리키도록 하십시오(원격 액세스 참조).여러 에이전트에 별도의 VPS가 필요한가요?
여러 에이전트에 별도의 VPS가 필요한가요?
VPS에서 SSH를 사용하는 대신 개인 노트북에서 Node를 사용하면 어떤 이점이 있나요?
VPS에서 SSH를 사용하는 대신 개인 노트북에서 Node를 사용하면 어떤 이점이 있나요?
- 인바운드 SSH 불필요 - Node는 기기 페어링을 통해 Gateway WebSocket으로 아웃바운드 연결합니다.
- 더 안전한 실행 제어 -
system.run은 해당 노트북의 Node 허용 목록/승인을 통해 제어됩니다. - 더 다양한 기기 도구 - Node는
system.run외에도canvas,camera,screen을 제공합니다. - 로컬 브라우저 자동화 - Gateway는 VPS에 유지하면서 Node 호스트를 통해 Chrome을 로컬에서 실행하거나 Chrome MCP를 통해 로컬 Chrome에 연결할 수 있습니다.
Node에서 Gateway 서비스를 실행하나요?
Node에서 Gateway 서비스를 실행하나요?
gateway, discovery 및 호스팅되는 Plugin 표면을 변경한 후에는 전체 재시작이 필요합니다.API/RPC를 통해 구성을 적용할 수 있나요?
API/RPC를 통해 구성을 적용할 수 있나요?
config.schema.lookup: 작성하기 전에 얕은 스키마 노드, 일치하는 UI 힌트 및 직계 하위 항목 요약과 함께 하나의 구성 하위 트리를 검사합니다.config.get: 현재 스냅샷과 해시를 가져옵니다.config.patch: 안전한 부분 업데이트입니다(대부분의 RPC 편집에 권장). 가능한 경우 핫 리로드하고, 필요한 경우 재시작합니다.config.apply: 전체 구성을 검증하고 교체합니다. 가능한 경우 핫 리로드하고, 필요한 경우 재시작합니다.- 에이전트용
gateway런타임 도구는 여전히tools.exec.ask/tools.exec.security재작성을 거부합니다. 레거시tools.bash.*별칭은 동일하게 보호되는 경로로 정규화됩니다.
첫 설치를 위한 최소한의 적절한 구성
첫 설치를 위한 최소한의 적절한 구성
VPS에 Tailscale을 설정하고 Mac에서 연결하려면 어떻게 해야 하나요?
VPS에 Tailscale을 설정하고 Mac에서 연결하려면 어떻게 해야 하나요?
- VPS에 설치하고 로그인합니다:
- 동일한 tailnet을 사용하여 Tailscale 앱으로 Mac에 설치하고 로그인합니다.
- VPS가 안정적인 이름을 갖도록 Tailscale 관리 콘솔에서 MagicDNS를 활성화합니다.
- tailnet 호스트 이름을 사용합니다: SSH
ssh user@your-vps.tailnet-xxxx.ts.net, Gateway WSws://your-vps.tailnet-xxxx.ts.net:18789.
Mac 노드를 원격 Gateway에 연결하려면 어떻게 해야 하나요(Tailscale Serve)?
Mac 노드를 원격 Gateway에 연결하려면 어떻게 해야 하나요(Tailscale Serve)?
- VPS와 Mac이 동일한 tailnet에 있는지 확인하십시오.
- macOS 앱을 Remote 모드로 사용하십시오(SSH 대상에는 tailnet 호스트 이름을 사용할 수 있습니다). 앱이 Gateway 포트를 터널링하고 노드로 연결됩니다.
- 노드를 승인하십시오.
두 번째 노트북에 설치해야 하나요, 아니면 노드만 추가하면 되나요?
두 번째 노트북에 설치해야 하나요, 아니면 노드만 추가하면 되나요?
환경 변수 및 .env 로드
OpenClaw는 환경 변수를 어떻게 로드하나요?
OpenClaw는 환경 변수를 어떻게 로드하나요?
- 현재 작업 디렉터리의
.env. ~/.openclaw/.env의 전역 대체.env($OPENCLAW_STATE_DIR/.env).
.env 파일도 기존 환경 변수를 재정의하지 않습니다. 공급자 자격 증명 키는 작업 공간 .env에서 예외입니다. GEMINI_API_KEY, XAI_API_KEY, MISTRAL_API_KEY 같은 키와 기타 번들 공급자 인증 환경 변수는 작업 공간 .env에서 무시되며, 프로세스 환경, ~/.openclaw/.env 또는 설정의 env에 있어야 합니다.설정의 인라인 환경 변수는 프로세스 환경에 해당 변수가 없을 때만 적용됩니다.서비스를 통해 Gateway를 시작했더니 환경 변수가 사라졌습니다. 어떻게 해야 하나요?
서비스를 통해 Gateway를 시작했더니 환경 변수가 사라졌습니다. 어떻게 해야 하나요?
- 서비스가 셸 환경을 상속하지 않아도 로드되도록 누락된 키를
~/.openclaw/.env에 넣으십시오. - 셸 가져오기를 활성화하십시오(선택적 편의 기능).
이렇게 하면 로그인 셸을 실행하고 누락된 예상 키만 가져옵니다(절대 재정의하지 않음). 동일한 환경 변수는
OPENCLAW_LOAD_SHELL_ENV=1,OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000입니다.
COPILOT_GITHUB_TOKEN을 설정했는데 모델 상태에 "Shell env: off."가 표시되는 이유는 무엇인가요?
COPILOT_GITHUB_TOKEN을 설정했는데 모델 상태에 "Shell env: off."가 표시되는 이유는 무엇인가요?
openclaw models status는 셸 환경 가져오기가 활성화되어 있는지를 보고합니다. “Shell env: off”는 환경 변수가 누락되었다는 의미가 아닙니다. OpenClaw가 로그인 셸을 자동으로 로드하지 않는다는 의미일 뿐입니다.Gateway가 서비스(launchd/systemd)로 실행되면 셸 환경을 상속하지 않습니다. 토큰을 ~/.openclaw/.env에 넣거나, env.shellEnv.enabled: true를 활성화하거나, 설정의 env에 추가하십시오(누락된 경우에만 적용). 그런 다음 Gateway를 다시 시작하고 다음 명령으로 다시 확인하십시오.OPENCLAW_GITHUB_TOKEN, COPILOT_GITHUB_TOKEN, GH_TOKEN, GITHUB_TOKEN 순서로 확인됩니다./concepts/model-providers 및 /environment를 참조하십시오.세션 및 여러 채팅
새 대화를 시작하려면 어떻게 해야 하나요?
새 대화를 시작하려면 어떻게 해야 하나요?
/new 또는 /reset을 단독 메시지로 보내십시오. 세션 관리를 참조하십시오./new를 보내지 않아도 세션이 자동으로 초기화되나요?
/new를 보내지 않아도 세션이 자동으로 초기화되나요?
session.reset.atHour, 기본값 4, 0-23)에 세션이 전환됩니다. 대신 mode: "idle" 및 session.reset.idleMinutes를 사용하면 유휴 시간 기반 초기화로 전환할 수 있습니다. 이 방식은 일정 기간 활동이 없으면 세션을 만료합니다(Heartbeat/Cron/exec 시스템 이벤트가 아니라 마지막 실제 상호 작용을 기준으로 함).resetByType은 direct(레거시 별칭 dm), group, thread를 지원합니다. 최상위 레거시 session.idleMinutes는 session.reset/resetByType 블록이 설정되지 않은 경우 유휴 모드 기본값의 호환성 별칭으로 계속 작동합니다. 공급자가 소유한 CLI 세션이 활성화된 세션에는 암시적 일일 기본 초기화가 적용되지 않습니다. 전체 수명 주기는 세션 관리를 참조하십시오.OpenClaw 인스턴스 팀(CEO 하나와 여러 에이전트)을 구성할 수 있나요?
OpenClaw 인스턴스 팀(CEO 하나와 여러 에이전트)을 구성할 수 있나요?
작업 도중 컨텍스트가 잘린 이유는 무엇인가요? 어떻게 방지하나요?
작업 도중 컨텍스트가 잘린 이유는 무엇인가요? 어떻게 방지하나요?
- 봇에게 현재 상태를 요약하여 파일에 기록하도록 요청하십시오.
- 긴 작업 전에는
/compact를 사용하고, 주제를 전환할 때는/new를 사용하십시오. - 중요한 컨텍스트는 작업 공간에 보관하고 봇에게 다시 읽도록 요청하십시오.
- 긴 작업이나 병렬 작업에는 하위 에이전트를 사용하여 기본 채팅의 크기를 작게 유지하십시오.
- 이런 일이 자주 발생하면 컨텍스트 창이 더 큰 모델을 선택하십시오.
OpenClaw는 설치된 상태로 유지하면서 완전히 초기화하려면 어떻게 해야 하나요?
OpenClaw는 설치된 상태로 유지하면서 완전히 초기화하려면 어떻게 해야 하나요?
--profile / OPENCLAW_PROFILE)을 사용했다면 각 상태 디렉터리(기본값 ~/.openclaw-<profile>)를 초기화하십시오. 개발 전용 초기화인 openclaw gateway --dev --reset은 개발 설정, 자격 증명, 세션 및 작업 공간을 삭제합니다."context too large" 오류가 발생합니다. 초기화하거나 압축하려면 어떻게 해야 하나요?
"context too large" 오류가 발생합니다. 초기화하거나 압축하려면 어떻게 해야 하나요?
- 압축(대화는 유지하고 이전 대화 내용을 요약함):
/compact또는/compact <instructions>를 사용하여 요약 방식을 지정하십시오. - 초기화(동일한 채팅 키에 새 세션 ID 사용):
/new또는/reset.
agents.defaults.contextPruning)를 조정하여 오래된 도구 출력을 제거하거나 컨텍스트 창이 더 큰 모델을 사용하십시오.문서: Compaction, 세션 정리, 세션 관리."LLM request rejected: messages.content.tool_use.input field required"가 표시되는 이유는 무엇인가요?
"LLM request rejected: messages.content.tool_use.input field required"가 표시되는 이유는 무엇인가요?
input 없이 tool_use 블록을 생성했습니다. 일반적으로 세션 기록이 오래되었거나 손상되었음을 의미합니다(주로 긴 스레드 또는 도구/스키마 변경 후 발생).해결 방법: /new를 단독 메시지로 보내 새 세션을 시작하십시오.30분마다 Heartbeat 메시지가 표시되는 이유는 무엇인가요?
30분마다 Heartbeat 메시지가 표시되는 이유는 무엇인가요?
heartbeat.every가 설정되지 않은 경우에는 1h마다 실행됩니다. 다음과 같이 간격을 조정하거나 비활성화하십시오.HEARTBEAT.md가 존재하지만 실질적으로 비어 있으면(빈 줄, Markdown/HTML 주석, ATX 제목, 펜스 표시 또는 빈 목록 항목 틀만 포함) OpenClaw는 API 호출을 절약하기 위해 Heartbeat 실행을 건너뜁니다. 파일이 없으면 Heartbeat는 계속 실행되며 모델이 수행할 작업을 결정합니다.에이전트별 재정의에는 agents.list[].heartbeat를 사용합니다. 문서: Heartbeat.WhatsApp 그룹에 "봇 계정"을 추가해야 하나요?
WhatsApp 그룹에 "봇 계정"을 추가해야 하나요?
groupPolicy: "allowlist").그룹 답장을 사용자 본인에게만 제한하려면 다음과 같이 설정하십시오.WhatsApp 그룹의 JID는 어떻게 확인하나요?
WhatsApp 그룹의 JID는 어떻게 확인하나요?
OpenClaw가 그룹에서 답장하지 않는 이유는 무엇인가요?
OpenClaw가 그룹에서 답장하지 않는 이유는 무엇인가요?
그룹/스레드가 DM과 컨텍스트를 공유하나요?
그룹/스레드가 DM과 컨텍스트를 공유하나요?
작업 공간과 에이전트를 몇 개까지 만들 수 있나요?
작업 공간과 에이전트를 몇 개까지 만들 수 있나요?
- 디스크 증가: 활성 세션과 기록은 에이전트별 SQLite 데이터베이스에 저장됩니다. 레거시/보관 아티팩트는
~/.openclaw/agents/<agentId>/sessions/아래에 계속 누적될 수 있습니다. - 토큰 비용: 에이전트가 많을수록 동시 모델 사용량이 늘어납니다.
- 운영 오버헤드: 에이전트별 인증 프로필, 작업 공간 및 채널 라우팅이 필요합니다.
agents.defaults.workspace)를 유지하고, 디스크 사용량이 증가하면 openclaw sessions cleanup으로 오래된 세션을 정리하십시오(활성 SQLite 상태를 직접 편집하지 마십시오). openclaw doctor를 사용하여 방치된 작업 공간과 프로필 불일치를 찾으십시오.여러 봇이나 채팅을 동시에 실행할 수 있나요(Slack)? 어떻게 설정해야 하나요?
여러 봇이나 채팅을 동시에 실행할 수 있나요(Slack)? 어떻게 설정해야 하나요?
모델, 장애 조치 및 인증 프로필
모델 Q&A(기본값, 선택, 별칭, 전환, 장애 조치, 인증 프로필)는 모델 FAQ에 있습니다.Gateway: 포트, “이미 실행 중”, 원격 모드
Gateway는 어떤 포트를 사용합니까?
Gateway는 어떤 포트를 사용합니까?
gateway.port는 WebSocket + HTTP(Control UI, 훅 등)에 사용되는 단일 다중화 포트를 제어합니다. 우선순위는 다음과 같습니다.왜 openclaw gateway status에 "Runtime: running"이 표시되지만 "Connectivity probe: failed"라고 나옵니까?
왜 openclaw gateway status에 "Runtime: running"이 표시되지만 "Connectivity probe: failed"라고 나옵니까?
openclaw gateway status의 다음 줄을 확인하십시오. Probe target:(프로브가 사용한 URL), Listening:(실제로 포트에 바인딩된 항목), Last gateway error:(프로세스는 살아 있지만 포트가 수신 대기하지 않을 때 흔한 근본 원인).왜 openclaw gateway status에서 "Config (cli)"와 "Config (service)"가 다르게 표시됩니까?
왜 openclaw gateway status에서 "Config (cli)"와 "Config (service)"가 다르게 표시됩니까?
--profile / OPENCLAW_STATE_DIR 불일치).서비스에서 사용할 동일한 --profile / 환경으로 다음을 실행하여 수정하십시오."another gateway instance is already listening"은 무슨 뜻입니까?
"another gateway instance is already listening"은 무슨 뜻입니까?
ws://127.0.0.1:18789)를 바인딩하여 런타임 잠금을 적용합니다. EADDRINUSE로 바인딩에 실패하면 GatewayLockError(“another gateway instance is already listening”)를 발생시킵니다.수정 방법: 다른 인스턴스를 중지하거나 포트를 비우거나 openclaw gateway --port <port>로 실행하십시오.OpenClaw를 원격 모드(클라이언트가 다른 위치의 Gateway에 연결)로 실행하려면 어떻게 해야 합니까?
OpenClaw를 원격 모드(클라이언트가 다른 위치의 Gateway에 연결)로 실행하려면 어떻게 해야 합니까?
gateway.mode: "remote"를 설정하고 원격 WebSocket URL을 지정하십시오. 선택적으로 공유 비밀 원격 자격 증명도 설정할 수 있습니다.openclaw gateway는gateway.mode가local일 때만 시작됩니다(또는 재정의 플래그를 전달한 경우).- macOS 앱은 구성 파일을 감시하며 이 값이 변경되면 실시간으로 모드를 전환합니다.
gateway.remote.token/.password는 클라이언트 측 원격 자격 증명일 뿐이며, 자체적으로 로컬 Gateway 인증을 활성화하지 않습니다.
gateway.bind를 tailnet으로 설정했지만 루프백에서만 수신 대기합니다
gateway.bind를 tailnet으로 설정했지만 루프백에서만 수신 대기합니다
tailnet 바인딩은 네트워크 인터페이스에서 Tailscale IP(100.64.0.0/10)를 선택합니다. 시스템이 Tailscale에 연결되어 있지 않거나 인터페이스가 다운된 경우, Gateway는 다른 네트워크 인터페이스를 노출하는 대신 루프백으로 대체합니다.수정 방법: 해당 호스트에서 Tailscale을 시작하고 Gateway를 다시 시작하거나 gateway.bind: "loopback" / "lan"으로 명시적으로 전환하십시오.tailnet은 명시적 설정이며, auto는 루프백을 우선합니다. 필수 동일 호스트 127.0.0.1 리스너를 유지하면서 비루프백 노출을 Tailnet으로 제한하려면 gateway.bind: "tailnet"을 사용하십시오.같은 호스트에서 여러 Gateway를 실행할 수 있습니까?
같은 호스트에서 여러 Gateway를 실행할 수 있습니까?
OPENCLAW_CONFIG_PATH, OPENCLAW_STATE_DIR, agents.defaults.workspace, gateway.port로 격리하십시오.권장 사항: 인스턴스마다 openclaw --profile <name> ...(~/.openclaw-<name> 자동 생성), 프로필 구성마다 고유한 gateway.port(또는 수동 실행 시 --port), 그리고 openclaw --profile <name> gateway install로 프로필별 서비스를 사용하십시오.프로필은 서비스 이름에도 접미사를 붙입니다. launchd ai.openclaw.<profile>, systemd openclaw-gateway-<profile>.service, Windows OpenClaw Gateway (<profile>). 한정되지 않은 openclaw-gateway systemd 유닛은 기본 프로필에만 존재하며, 이름 변경 전의 레거시 systemd 유닛 이름 clawdbot-gateway는 자동으로 마이그레이션됩니다.전체 가이드: 여러 Gateway."invalid handshake" / 코드 1008은 무슨 뜻입니까?
"invalid handshake" / 코드 1008은 무슨 뜻입니까?
connect 프레임을 기대합니다. 다른 메시지가 오면 코드 1008(정책 위반)로 연결을 종료합니다.일반적인 원인: WS 클라이언트 대신 브라우저에서 HTTP URL을 열었거나, 잘못된 포트/경로를 사용했거나, 프록시/터널이 인증 헤더를 제거했거나 Gateway가 아닌 요청을 보냈습니다.수정 방법: WS URL(ws://<host>:18789 또는 HTTPS를 통한 wss://...)을 사용하고, 일반 브라우저 탭에서 WS 포트를 열지 말고, 인증이 활성화된 경우 connect 프레임에 토큰/비밀번호를 포함하십시오. CLI/TUI 예시:로깅 및 디버깅
로그는 어디에 있습니까?
로그는 어디에 있습니까?
/tmp/openclaw/openclaw-YYYY-MM-DD.log. logging.file로 고정 경로를, logging.level로 파일 로그 수준을, --verbose 및 logging.consoleLevel로 콘솔 상세도를 설정하십시오.가장 빠르게 추적하는 방법:- macOS launchd stdout:
~/Library/Logs/openclaw/gateway.log(프로필은gateway-<profile>.log사용, stderr는 억제됨). - Linux:
journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager. - Windows:
schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST.
Gateway 서비스를 시작/중지/다시 시작하려면 어떻게 해야 합니까?
Gateway 서비스를 시작/중지/다시 시작하려면 어떻게 해야 합니까?
openclaw gateway --force로 포트를 회수할 수 있습니다. Gateway를 참조하십시오.Windows에서 터미널을 닫았습니다. OpenClaw를 어떻게 다시 시작합니까?
Windows에서 터미널을 닫았습니다. OpenClaw를 어떻게 다시 시작합니까?
openclaw gateway run.3) 네이티브 Windows CLI/Gateway: Windows에서 직접 실행됩니다.openclaw gateway run.문서: Windows, Gateway 서비스 런북.Gateway는 실행 중이지만 응답이 도착하지 않습니다. 무엇을 확인해야 합니까?
Gateway는 실행 중이지만 응답이 도착하지 않습니다. 무엇을 확인해야 합니까?
"Disconnected from gateway: no reason" - 어떻게 해야 합니까?
"Disconnected from gateway: no reason" - 어떻게 해야 합니까?
Telegram setMyCommands가 실패합니다. 무엇을 확인해야 합니까?
Telegram setMyCommands가 실패합니다. 무엇을 확인해야 합니까?
BOT_COMMANDS_TOO_MUCH: Telegram 메뉴의 항목이 너무 많습니다. OpenClaw는 이미 Telegram 제한에 맞게 항목을 줄이고 더 적은 명령으로 재시도하지만, 일부 메뉴 항목은 여전히 누락될 수 있습니다. 플러그인/스킬/사용자 지정 명령을 줄이거나, 메뉴가 필요하지 않다면channels.telegram.commands.native를 비활성화하십시오.TypeError: fetch failed,Network request for 'setMyCommands' failed!또는 이와 유사한 네트워크 오류: VPS 또는 프록시 뒤에서 실행하는 경우 아웃바운드 HTTPS가 허용되어 있고api.telegram.org에 대한 DNS가 작동하는지 확인하십시오.
TUI에 출력이 표시되지 않습니다. 무엇을 확인해야 합니까?
TUI에 출력이 표시되지 않습니다. 무엇을 확인해야 합니까?
Gateway를 완전히 중지한 다음 다시 시작하려면 어떻게 해야 합니까?
Gateway를 완전히 중지한 다음 다시 시작하려면 어떻게 해야 합니까?
openclaw gateway run을 실행하십시오.문서: Gateway 서비스 런북.쉬운 설명: openclaw gateway restart와 openclaw gateway의 차이
쉬운 설명: openclaw gateway restart와 openclaw gateway의 차이
openclaw gateway restart는 백그라운드 서비스(launchd/systemd)를 다시 시작합니다. openclaw gateway는 이 터미널 세션에서 Gateway를 포그라운드로 실행합니다. 서비스를 설치했다면 Gateway 하위 명령을 사용하고, 일회성 실행에는 하위 명령 없는 포그라운드 실행을 사용하십시오.문제가 발생했을 때 세부 정보를 가장 빠르게 확인하는 방법
문제가 발생했을 때 세부 정보를 가장 빠르게 확인하는 방법
--verbose로 Gateway를 시작한 다음, 채널 인증, 모델 라우팅 및 RPC 오류를 로그 파일에서 확인하십시오.미디어 및 첨부 파일
내 스킬이 이미지/PDF를 생성했지만 아무것도 전송되지 않았습니다
내 스킬이 이미지/PDF를 생성했지만 아무것도 전송되지 않았습니다
media, mediaUrl, path 또는 filePath와 같은 구조화된 미디어 필드를 사용해야 합니다. OpenClaw 어시스턴트 설정 및 에이전트 전송을 참조하십시오.tools.fs.workspaceOnly=true가 로컬 경로 전송을 워크스페이스, 임시/미디어 저장소 및 샌드박스에서 검증된 파일로 제한하는지 확인하십시오. tools.fs.workspaceOnly=false(기본값)를 사용하면 구조화된 로컬 미디어 전송에서 에이전트가 이미 읽을 수 있는 호스트 로컬 파일을 미디어 및 안전한 문서 유형(이미지, 오디오, 동영상, PDF, Office 문서와 Markdown/MD, TXT, JSON, YAML/YML 같은 검증된 텍스트 문서)에 사용할 수 있습니다. 이는 비밀 스캐너가 아닙니다. 에이전트가 읽을 수 있는 secret.txt 또는 config.json은 확장자 및 콘텐츠 검증이 일치하면 첨부될 수 있습니다. 민감한 파일은 에이전트가 읽을 수 있는 경로 밖에 두거나, 더 엄격한 로컬 경로 전송을 위해 tools.fs.workspaceOnly=true를 유지하십시오.이미지를 참조하십시오.보안 및 액세스 제어
OpenClaw를 인바운드 DM에 노출해도 안전합니까?
OpenClaw를 인바운드 DM에 노출해도 안전합니까?
- DM을 지원하는 채널의 기본 동작은 페어링입니다. 알 수 없는 발신자는 페어링 코드를 받으며 메시지는 처리되지 않습니다.
openclaw pairing approve --channel <channel> [--account <id>] <code>로 승인하십시오. 대기 중인 요청은 채널당 3개로 제한됩니다. 코드가 도착하지 않았다면openclaw pairing list --channel <channel> [--account <id>]를 확인하십시오. - DM을 공개적으로 개방하려면 명시적으로 사용 설정해야 합니다(
dmPolicy: "open"및 허용 목록"*").
openclaw doctor를 실행하십시오.프롬프트 인젝션은 공개 봇에서만 문제가 됩니까?
프롬프트 인젝션은 공개 봇에서만 문제가 됩니까?
- 읽기 전용 또는 도구가 비활성화된 “리더” 에이전트를 사용하여 신뢰할 수 없는 콘텐츠를 요약합니다.
- 도구가 활성화된 에이전트에서는
web_search/web_fetch/browser를 비활성화합니다. - 디코딩된 파일/문서 텍스트도 신뢰할 수 없는 것으로 취급합니다. OpenResponses
input_file과 미디어 첨부 파일 추출은 모두 원시 파일 텍스트를 전달하는 대신, 추출된 텍스트를 명시적인 외부 콘텐츠 경계 마커로 감쌉니다. - 샌드박스를 사용하고 엄격한 도구 허용 목록을 적용합니다.
OpenClaw가 Rust/WASM 대신 TypeScript/Node를 사용하므로 덜 안전합니까?
OpenClaw가 Rust/WASM 대신 TypeScript/Node를 사용하므로 덜 안전합니까?
openclaw security audit --deep을 실행하십시오.자세한 내용: 보안, 샌드박싱.노출된 OpenClaw 인스턴스에 관한 보고를 보았습니다. 무엇을 확인해야 합니까?
노출된 OpenClaw 인스턴스에 관한 보고를 보았습니다. 무엇을 확인해야 합니까?
loopback에 바인딩하거나 인증된 비공개 액세스(tailnet, SSH 터널, 토큰/비밀번호 인증 또는 올바르게 구성된 신뢰할 수 있는 프록시)를 통해서만 노출합니다. DM은 pairing 또는 allowlist 모드로 설정합니다. 모든 구성원을 신뢰하는 경우가 아니라면 그룹을 허용 목록에 추가하고 멘션을 필수로 설정합니다. 신뢰할 수 없는 콘텐츠를 읽는 에이전트에서는 고위험 도구(exec, browser, gateway, cron)를 거부하거나 범위를 엄격히 제한합니다. 도구 실행의 피해 범위를 줄여야 하는 경우 샌드박싱을 활성화합니다.인증 없는 공개 바인딩, 도구가 활성화된 개방형 DM/그룹, 노출된 브라우저 제어를 가장 먼저 수정해야 합니다. 자세한 내용: openclaw security audit.ClawHub 스킬과 타사 플러그인을 설치해도 안전합니까?
ClawHub 스킬과 타사 플러그인을 설치해도 안전합니까?
security.installPolicy를 사용하십시오.더 안전한 패턴은 다음과 같습니다. 신뢰할 수 있는 작성자와 고정된 버전을 선호하고, 스킬/플러그인을 활성화하기 전에 내용을 읽으며, 플러그인/스킬 허용 목록을 좁게 유지하고, 최소한의 도구만 제공되는 샌드박스에서 신뢰할 수 없는 입력 워크플로를 실행하며, 타사 코드에 광범위한 파일 시스템, exec, 브라우저 또는 비밀 액세스 권한을 부여하지 마십시오.자세한 내용: Skills, 플러그인, 보안.봇에 별도의 이메일, GitHub 계정 또는 전화번호를 제공해야 합니까?
봇에 별도의 이메일, GitHub 계정 또는 전화번호를 제공해야 합니까?
내 문자 메시지를 자율적으로 처리하도록 해도 되며, 안전합니까?
내 문자 메시지를 자율적으로 처리하도록 해도 되며, 안전합니까?
개인 어시스턴트 작업에 더 저렴한 모델을 사용할 수 있습니까?
개인 어시스턴트 작업에 더 저렴한 모델을 사용할 수 있습니까?
Telegram에서 /start를 실행했지만 페어링 코드를 받지 못했습니다
Telegram에서 /start를 실행했지만 페어링 코드를 받지 못했습니다
dmPolicy: "pairing"이 활성화된 경우에만 전송됩니다. /start만으로는 코드가 생성되지 않습니다.대기 중인 요청을 확인하십시오.dmPolicy: "open"을 설정하십시오.WhatsApp: 내 연락처에 메시지를 보냅니까? 페어링은 어떻게 작동합니까?
WhatsApp: 내 연락처에 메시지를 보냅니까? 페어링은 어떻게 작동합니까?
channels.whatsapp.selfChatMode를 활성화하십시오.채팅 명령, 작업 중단 및 “중지되지 않음”
채팅에 내부 시스템 메시지가 표시되지 않게 하려면 어떻게 해야 합니까?
채팅에 내부 시스템 메시지가 표시되지 않게 하려면 어떻게 해야 합니까?
verboseDefault: "on"인 봇 프로필을 사용하고 있지 않은지도 확인하십시오.문서: 사고 및 상세 출력, 보안.실행 중인 작업을 중지/취소하려면 어떻게 해야 합니까?
실행 중인 작업을 중지/취소하려면 어떻게 해야 합니까?
stop, stop action, stop current action, stop run, stop current run, stop agent, stop the agent, stop openclaw, openclaw stop, stop don't do anything, stop do not do anything, stop doing anything, do not do that, please stop, stop please, abort, esc, exit, interrupt, halt. 일반적인 비영어권 트리거(프랑스어, 독일어, 스페인어, 중국어, 일본어, 힌디어, 아랍어, 러시아어)도 작동합니다.exec 도구로 시작된 백그라운드 프로세스의 경우 에이전트에게 다음을 실행하도록 요청하십시오./로 시작하는 독립된 메시지로 보내야 하지만, 일부 단축 명령(예: /status)은 허용 목록에 있는 발신자가 인라인으로 사용해도 작동합니다. 슬래시 명령을 참조하십시오.Telegram에서 Discord 메시지를 어떻게 보내나요? ("컨텍스트 간 메시징이 거부됨")
Telegram에서 Discord 메시지를 어떻게 보내나요? ("컨텍스트 간 메시징이 거부됨")
봇이 빠르게 연속으로 보낸 메시지를 "무시하는" 것처럼 느껴지는 이유는 무엇인가요?
봇이 빠르게 연속으로 보낸 메시지를 "무시하는" 것처럼 느껴지는 이유는 무엇인가요?
/queue를 사용하여 활성 실행 동작을 선택하십시오.steer(기본값) - 다음 모델 경계에서 활성 실행을 유도합니다.followup- 메시지를 큐에 넣고 현재 실행이 끝난 후 하나씩 실행합니다.collect- 호환되는 메시지를 큐에 넣고 현재 실행이 끝난 후 한 번만 응답합니다.interrupt- 현재 실행을 중단하고 새로 시작합니다.
debounce:0.5s cap:25 drop:summarize 같은 옵션을 추가할 수 있습니다. 명령 큐와 스티어링 큐를 참조하십시오.기타
API 키를 사용할 때 Anthropic의 기본 모델은 무엇인가요?
API 키를 사용할 때 Anthropic의 기본 모델은 무엇인가요?
ANTHROPIC_API_KEY를 설정하거나 인증 프로필에 Anthropic API 키를 저장하면 인증이 활성화되지만, 실제 기본 모델은 agents.defaults.model.primary에 구성한 모델입니다(예: anthropic/claude-sonnet-4-6 또는 anthropic/claude-opus-4-6). No credentials found for profile "anthropic:default"는 Gateway가 실행 중인 에이전트의 예상 auth-profiles.json에서 Anthropic 자격 증명을 찾지 못했다는 의미입니다.그래도 해결되지 않나요? Discord에서 질문하거나 GitHub 토론을 시작하십시오.