개발자가 알아야 할 오픈클로의 네 가지 주요 이슈

최근 OpenClaw 저장소(별 366k)의 열린 이슈를 스캔한 결과, 프로덕션 배포에 적극적으로 영향을 미치는 네 가지 버그와 기능 부재가 발견되었습니다. 두 가지는 무음 실패를 일으키는 버그이고, 두 가지는 커뮤니티에서 요청해 온 누락된 기능입니다. 각각에 대한 설명입니다.

1. 채널을 통해 전송된 이미지가 모델에 도달하지 않음

사용자가 Discord, Telegram, Feishu 또는 OpenWebUI를 통해 이미지를 보내면, 채널 어댑터가 이미지를 제거하고 텍스트만 모델에 전달합니다. 비전 지원 모델은 이미지가 제공되지 않은 것처럼 응답하거나 설명을 환각합니다. 근본 원인은 채널 어댑터 인터페이스가 이미지 URL이나 base64 페이로드를 전파하지 않기 때문입니다. 수정은 이러한 이미지 표현을 전달하도록 어댑터 인터페이스를 확장해야 합니다. 여러 이슈가 이를 추적하며, #23452가 가장 명확한 요약입니다.

2. WhatsApp과 Telegram이 짧은 DNS 장애 시 영구히 중단됨

WhatsApp 및 Telegram 채널 어댑터의 재연결 로직은 세션 중간 연결 해제만 처리합니다. 초기 연결 중 DNS 오류가 발생하면 오류가 재시도 루프를 완전히 벗어나고, 채널은 더 이상 재연결 시도 없이 종료됩니다. 게이트웨이는 계속 실행되지만 채널은 사실상 죽습니다. 사용자들은 이를 다시 시작하기 위해 외부 감시 스크립트를 실행한다고 보고합니다. 이슈 #2198 및 #13506을 참조하세요.

3. 세션 잠금을 보유한 항목을 볼 수 있는 방법 없음

세션 저장소는 .jsonl.lock 파일을 사용하며, 큰 세션, 크론 부하, 병렬 에이전트 또는 구성 재로드로 인해 자주 멈춥니다. 잠금이 멈추면 모든 모델이 session file locked (timeout 10000ms) 오류로 실패합니다. 유일한 복구 방법은 잠금 파일을 수동으로 삭제하거나 게이트웨이를 다시 시작하는 것입니다. 잠금 파일에는 이미 pid 및 createdAt 메타데이터가 포함되어 있지만, 이를 표시하는 CLI 명령이 없습니다. 제안된 openclaw locks 명령은 해당 메타데이터를 읽고 활성 대기자를 표시하여 운영자에게 실행 가능한 통찰력을 제공할 것입니다. 이슈 #31489 및 #11950을 참조하세요.

4. 에이전트 간 병렬 조정 없음

현재 session_spawn 및 send 도구는 계층적 위임만 지원합니다. 한 에이전트가 작업을 전달하고 기다립니다. 여러 에이전트가 동시에 작업을 협력하거나 상태를 공유할 수 있는 방법이 없습니다. 이슈 #43367은 사용자들이 병렬 코딩 에이전트를 실행하려다 구성 덮어쓰기와 잠금 경합에 부딪히는 것을 문서화하고 있습니다.

이 네 가지 항목은 기여를 위해 열려 있으며 프로덕션 설정에 직접적인 영향을 미치고 있습니다. 프로덕션에서 OpenClaw를 실행 중이라면 채널 어댑터와 세션 잠금 관리를 확인하고, 수정 사항을 기여해 보시기 바랍니다.