OpenClaw v2026.3.13에서 하위 에이전트가 표시되지 않는 문제 수정

문제: v2026.3.13에서 하위 에이전트가 보이지 않음

OpenClaw 버전 2026.3.13에서 일부 사용자는 메인 에이전트만 에이전트 목록에 나타나고 사용자 정의 하위 에이전트는 보이지 않는다고 보고합니다. 이 문제는 사용자 정의 스쿼드 멤버에 대한 자동 경로 탐색과 관련이 있는 것으로 보입니다.

해결 방법: 강제 연결 방법

로그를 분석한 후, 커뮤니티 구성원이 두 가지 구성 변경을 포함하는 신뢰할 수 있는 해결 방법을 발견했습니다.

1. openclaw.json 간소화

2026.3 파서는 에이전트 목록에 "path"와 같은 추가 키가 포함되어 있을 때 실패할 수 있습니다. 목록을 "id" 값만 포함하도록 최소한으로 유지하세요:

"list": [
  { "id": "main", "tools": { "alsoAllow": ["agents_list"], "deny": ["cron"] } },
  { "id": "librarian" },
  { "id": "matrix" }
]

중요: 후행 쉼표와 대괄호를 확인하세요. "list"는 "agents" 섹션에 대해 ]로 끝나고 }로 끝나야 합니다.

2. runs.json을 통한 수동 등록

시스템이 에이전트를 감지하지 못하는 경우, .openclaw/subagents/runs.json(또는 설정에 따라 루트 runs.json)에서 수동으로 등록하세요. 상태를 "idle"로 설정하여 활성화하세요:

{
  "version": 2,
  "runs": {
    "librarian": {
      "id": "librarian",
      "path": "C:\\Users\\YOUR_USERNAME\\.openclaw\\subagents\\Librarian_Synapse.md",
      "status": "idle"
    }
  }
}

3. 확인

이러한 변경 사항을 적용한 후 게이트웨이를 재시작하고 /agents 명령을 사용하세요. 이제 스쿼드가 나타나야 합니다(예: "Agents (1)" 대신 "Agents (8)" 표시). 그런 다음 @agent_name 태그를 사용하여 작업을 위임할 수 있습니다.