분명히 봤잖아 게이트웨이가 실행 중입니다.、RPC 감지도 녹색입니다., 하지만 Telegram/Slack에서는소식이 그냥 안 나오네요, 에이전트는 "연결이 끊어졌지만 오류를 보고하지 않습니다"와 같습니다. 이 기사에서는 작동 및 유지 관리에 대한 조언을 제공합니다.채널 레이어문제 해결 경로: 먼저 7개의 목록을 사용하여 "제어 표면이 정상 ≠ 메시지 표면이 정상"이라는 착각을 제거한 다음 하나를 사용합니다.증상과 근본 원인조회 테이블은 페어링으로 수렴되며,dmPolicy, 그룹 채팅 멘션 및 봇 권한이 최종 부여되었습니다.6단계 최소 복구 런북, 사이트와 명확하게 관련됨 준비되지 않음/시작이 중단됨、게이트웨이 폐쇄(1000)、크로스 플랫폼 설치 분업독서법.
OpenClaw 넣어제어 평면, 세션 평면, 채널 평면, 모델 백엔드다양한 수준에서 해체됨; 그냥 봐openclaw gateway status'모델이 깨졌다'고 문제를 오진하기 쉽다. 세 가지 유형의 로그 사이에서 팀이 공회전하는 것을 방지하기 위해 검토 전 자체 점검에 다음 7가지 항목을 사용합니다.
RPC OK를 메시지 링크 OK로 처리합니다.RPC는 기본 제어 평면 연결 가능성을 다중 검증합니다. DM/그룹 라우팅은 페어링, 웹훅 연결 가능성 및 정책 적중에도 따라 달라집니다.
봇 측 권한 변경 무시:채널 관리자가 권한을 변경한 후에도 봇이 그룹에서 제거되거나 토큰이 교체된 후에도 게이트웨이가 계속 실행 중인 것으로 표시될 수 있습니다.
dmPolicy 복사 및 붙여넣기가 너무 엄격합니다.허용 목록이 빈 세트 또는 이전 작업 공간과 실수로 일치하는 경우 "정상이지만 모두 거부됨"이 나타납니다. 와 일치해야 한다보안 강화 비교해서 읽어보세요.
그룹 채팅은 멘션 게이트 제어를 충족하지 않습니다.그룹 정책에 따라 @Bot이 응답해야 하는 경우 사용자가 "보냈어요"라고 말하는 것이 게이팅 조건에 도달했다는 의미는 아닙니다.
MCP 도구 체인 문제를 채널 문제로 처리합니다.도구가 응답하지 않는 증상은 메시지가 수신되지 않는 증상과 유사합니다. 먼저 배제해야합니다.MCP 연결 채널로 돌아갑니다.
업그레이드 후에는 구성만 볼 수 있고 페어링 상태는 볼 수 없습니다.새 버전의 더 엄격한 인증 기본값으로 인해 페어링이 "반 무효화"될 수 있습니다. 공식 FAQ에 따라 페어링을 다시 실행해야 합니다.
다중 게이트웨이/다중 프로필 드리프트:systemd와 CLI는 다르게 읽습니다.openclaw.json"체크한 녹색은 사용자에게 연결된 인스턴스가 아닙니다."라는 메시지가 나타납니다.
이러한 함정의 일반적인 근본 원인은 다음과 같습니다.접근성그리고배달 가능성혼란스러움: 전자는 "프로세스와 포트가 살아 있는지"라고 대답하고, 후자는 "이 DM이 정책에 의해 허용되는지, 세션에 들어가는지, 모델 백엔드에서 소비되는지"라고 대답합니다. 원장에 기록한 후 다음 표를 사용하여 증상을 수준별로 고정합니다.
둘 다 유지한다면 준비가 안 됐어 그리고 휴무(1000)런북 세트는 두 개입니다. 이 기사를 세 번째 볼륨으로 취급하십시오. "시작 및 세션"을 제외하고 여전히 뉴스가 없으면 채널 조사 및 전략으로 돌아가십시오.
그리고 게이트웨이 보안 강화 연결: 조이세요 dmPolicy메시지 항목이 크게 변경되며 변경 사항에는 카나리아 및 롤백 지침이 수반되어야 합니다.
묘책은 없습니다. 먼저 대답해야 합니다.메시지가 어느 층에 붙어 있나요?을 클릭한 다음 구성이나 권한을 변경할지 여부를 결정합니다. 검토 중에는 메시지 인바운드 지연, 실패 설명 가능성, 정책 변경에 대한 롤백 시간 등 세 가지 SLA를 명확하게 기록합니다.
| 당신이 보는 것 | 근본 원인 계층일 가능성이 높음 | 선호하는 검증 |
|---|---|---|
| 게이트웨이가 준비되지 않음/시작 시간 초과 | 시작 및 상태 확인 레이어 | 읽다 준비되지 않음 문제 해결;포트, 메모리를 살펴보고 시작 순서를 구성합니다. |
| RPC는 녹색이지만 도구가 비정상적이거나 닫혔습니다(1000) | 세션, 범위, 토큰, 모델 백엔드 | 읽다 마감(1000)개 기사;조정 openclaw status의사와 함께 |
| 채널 프로브 실패 또는 채널 연결 끊김 | 채널 연결 및 자격 증명 | openclaw channels status --probe;봇 토큰 및 웹훅 연결 가능성 확인 |
| 프로브가 모두 녹색이지만 여전히 인바운드가 없습니다. | 정책: dmPolicy / 그룹 채팅 게이팅 / 멘션 | 제어 안전이 글의 섹션 4에 있는 최소 재현 실험을 통해 |
| 메시지가 왔지만 상담원이 응답하지 않습니다. | 모델 측 할당량, CLI 전용, 다운스트림 시간 초과 | openclaw models status;그리고 모델라우팅 연속 읽기 |
"게이트웨이 정상"은 다음을 나타냅니다.컨트롤 표면이 살아있습니다; 당신이 사고 싶은 것은메시지 전달 가능성: 매치메이킹, 전략, 채널 API 기능은 동일한 수락 양식에 있어야 합니다.
Linux VPS에서 게이트웨이를 실행하는 경우 무거운 도구 체인을원격 Mac 전용 노드, "메시지 입력"과 "도구 실행"을 두 개의 서로 다른 업무 런북에 작성하세요. 전자는 채널과 전략을 살펴보고 후자는 SSH와 리소스 수준을 살펴봅니다.
그리고 OpenClaw 카테고리 목록연결: 설치, Docker, systemd, 관찰 및 보안에 대한 기사는 "모든 기사가 게이트웨이가 무엇인지에 대해 처음부터 시작하는" 것을 방지하기 위해 공통 컨텍스트를 설정해야 합니다.
다음 순서는 "첫 번째 글로벌 스냅샷, 그 다음 채널 조사, 그 다음 전략 및 일치, 마지막으로 대수술"을 강조합니다. 공식 FAQ의 "처음 60초"와 동일하지만 완료되었습니다.그룹 채팅 및 dmPolicy 일반적인 사각지대.
실행 개요:openclaw status, OS, 업데이트, 게이트웨이에 연결할 수 있는지, 에이전트/세션 및 공급자 프롬프트에 차단 항목이 없는지 확인하세요.
채널 프로브 실행:openclaw channels status --probe, 먼저 연결 끊김/인증 오류를 삭제하세요.
컬럼 페어링:openclaw pairing list --channel telegram(실제 채널에 따라 교체) 보류/만료 처리.
비교 전략:검토 dmPolicy, 그룹 채팅 게이팅 및 언급 규칙은 근무 일정과 일치합니다. 변경하기 전에 백업openclaw.json。
게이트웨이를 다시 시작하고 다음을 검토합니다.openclaw gateway restart그런 다음 01~02를 반복합니다. 여전히 비정상이라면 다시 시도해 보세요.openclaw doctor。
그래도 실패하면 최소 정보 패킷을 수집하십시오.버전, 관련 구성 조각 및 50줄의 전후 로그(코딩 토큰)를 통해 보조 문제 해결 또는 커뮤니티 도움말을 용이하게 합니다.
openclaw status openclaw gateway status openclaw channels status --probe openclaw pairing list --channel telegram openclaw logs --follow openclaw doctor
힌트:방금 바꿨다면 gateway.bind아니면 역생성 경로도 동시에 확인해주세요보안 강화루프백과 토큰의 조합은 "제어 표면에 도달할 수 있는 것처럼 보이지만 실제로는 웹훅에 접근할 수 없습니다"를 방지할 수 있습니다.
업그레이드 후 "채널이 모두 녹색인데 여전히 메시지가 들어오지 않습니다"라는 메시지가 나타나면 우선적으로 의심해 보세요.인증 기본 강화와 페어링 드리프트: 공식 업그레이드 노트에 따라 재실행openclaw gateway install --force의사와 함께 비즈니스 프롬프트를 먼저 다시 작성하는 대신.
그리고 휴무(1000)기사 링크: 로그에 종료 프레임이 있는 경우 먼저 세션 레이어로 돌아가서 범위/토큰을 정렬한 다음 기사 채널 전략으로 돌아가야 합니다. 그렇지 않으면 잘못된 레이어가 반복적으로 변경됩니다.
가장 흔한 유형의 생산사고는 다음과 같습니다.정책이 너무 엄격하고 의무 문서가 동기화되지 않음: 게이트웨이 로그도 조용하고 지표도 조용하지만 비즈니스 측면에서는 "에이전트가 죽은 척하고 있다"는 느낌이 듭니다. 이 섹션에서는 최소한의 재생산 실험을 제공합니다. 먼저 사용하세요.비공개 채팅Bot이 여전히 사용 가능한지 확인한 다음 그룹 채팅으로 다시 전환하여 도어 제어를 하나씩 해제합니다.
Telegram/Slack과 같은 채널의 경우 먼저 세 가지 유형의 목록을 확인하세요.봇이 아직 그룹에 있나요?、@mention 요구 여부、주제/스레드 제한 여부; 다시 dmPolicy허용 목록은 작업공간 경로에 맞춰 정렬됩니다.안전최소 노출의 원칙.
알아채다:문제 해결을 위해 피크 기간 동안 직접 "dmPolicy를 해제"하지 마세요. 먼저 열어보세요.읽기 전용 감사그리고섀도우 채널(소규모 계정 그룹/테스트 봇) 생산 전략에 수렴하기 전에 규칙이 적중되었는지 확인하십시오.
게이트웨이가 VPS에서 실행되고 도구가 VPS에서 실행되는 경우원격 Mac 전용 노드, "메시지 입력 전략"과 "SSH 실행 전략"을 별도로 검토하십시오. 전자의 오류는 사용자로 하여금 전체 사이트가 다운된 것처럼 느끼게 하는 반면, 후자의 오류는 일부 도구의 작동 중단을 야기할 뿐입니다.
다음 항목은 내부 정렬을 위한 것입니다. 구체적인 임계값은 채널 규모와 규정 준수 요구 사항에 따라 달라집니다.
dmPolicy/그룹 게이팅 클래스 변경은 최소한 예약되어야 합니다.완전한 페어링 반환그리고롤백 백업, 저녁 출퇴근 시간을 피하기 위해 "한 줄을 완전히 무음으로 변경"하세요.순수 로컬 또는 임시 VPS는 게이트웨이를 실행합니다.절전, 포트 드리프트, 인증서 및 IM 플랫폼 전류 제한사이에서 반복하십시오. 그리고 안정적으로 실행해야xcodebuild / CLI 에이전트 / 상주 도구 체인팀이 더 적합하다컴퓨팅 파워 및 데스크탑 상태넣다독점, 장기 온라인원격 Mac 노드에서는 게이트웨이를 Linux 시스템에 두고 메시징 및 오케스트레이션에 집중합니다. 불안정한 가상화 환경에서 분산된 머신을 직접 구축하거나 macOS를 엮는 것과 비교하면,NodeMini의 Mac Mini 클라우드 대여고정된 SSH, 깨끗한 디스크 파일 및 복제 가능한 노드 이미지는 "메시지 입력"에서 "도구 실행"을 분리하는 데 더 도움이 됩니다. 사양과 가격을 비교해야 할 때 먼저 읽어보세요.임대 가격 설명, 와 결합 도움말 센터 계획 노드.
구현할 때 이 Runbook을 내부 "채널 변경 수준"에 바인딩하는 것이 좋습니다. 봇 권한, 그룹 정책, 게이트웨이 버전 및 모델 백엔드 전환은 다른 승인 및 카나리아 범위를 사용해야 합니다.
RPC 다중 인증 제어 플레인에 도달할 수 있습니다. 메시지가 세션에 들어가는지 여부는 채널 페어링, 봇 권한, dmPolicy 및 그룹 채팅 게이팅에 따라 달라집니다. 이 문서의 섹션 3의 순서를 따르십시오.channels status --probe 그리고 pairing list. 노드 및 네트워크 측 제안이 필요한 경우 이를 볼 수 있습니다.도움말 센터。
비공개(1000) 문서는 업그레이드 후 세션 범위, 토큰 및 도구 예외에 중점을 둡니다. 이 문서에서는 채널 계층 메시지 흐름에 중점을 둡니다. 로그에 닫기 프레임이 자주 나타나는 경우 두 개의 기사를 연속해서 읽어야 합니다. 먼저 세션과 세션 백엔드를 제외하고 페어링 및 전략으로 돌아갑니다. OpenClaw 관련 기사는 다음에서 찾을 수 있습니다.블로그 OpenClaw 필터링 입력하다.