OpenClaw 2026.4.19-beta.2 업데이트 및 멀티세션 설정

OpenClaw 2026.4.19-beta.2 업데이트 및 멀티세션 설정

개요

OpenClaw 멀티세션/서브에이전트 버그 해결을 위한 베타 버전 업데이트 및 Discord 연결 설정

업데이트 내역

업데이트 대상

• 버전: 2026.4.15 → 2026.4.19-beta.2 (dc3df91)
• 대상 장비:
  • 맥미니 (게이트웨이)
  • 메인컴 (PS-i14700k, WSL)
  • 보조컴 (WSL)

업데이트 방법

npm install -g openclaw@beta

권한 문제 시:

sudo npm install -g openclaw@beta

업데이트 확인

openclaw --version
# 출력: OpenClaw 2026.4.19-beta.2 (dc3df91)

주요 버그 수정 (Issue #45868)

문제 원인

• 발생 버전: 2026.3.12
• 증상: sessions_spawn이 target agentId 대신 requester(부모) 세션의 workspace를 해석
• 영향: 서브에이전트가 부모의 SOUL.md와 설정을 상속받아 자신의 identity를 잃음

해결 PR

• PR #67785: 중첩 에이전트 레인 개선
• PR #67508: cross-agent 서브에이전트 채널 라우팅 개선

Discord 연결 설정

설정 위치

~/.openclaw/openclaw.json

Discord 설정 예시

"channels": {
  "discord": {
    "enabled": true,
    "token": "봇_토큰",
    "groupPolicy": "allowlist",
    "guilds": {
      "서버이름/#채널명": {}
    }
  }
}

핵심 설정 포인트

• Allowlist: “서버ID”만 입력하면 작동 안 함
• 올바른 형식: “서버이름/#채널명” (예: “MiniCITY/#일반”)

Discord Developer Portal 설정

• OAuth2 Code Grant: OFF
• Message Content Intent: ON
• Public Bot: ON (또는 OFF)

서브에이전트 세션 모드

일회용 모드 (기본)

sessions_spawn({
  runtime: "subagent",
  mode: "run",  // 한 번 실행 후 종료
  task: "..."
})

지속 세션 모드

sessions_spawn({
  runtime: "subagent",
  mode: "session",      // 세션 유지
  timeoutSeconds: 0,    // 무제한
  thread: true,         // Discord 스레드 바인딩 (Discord 전용)
  task: "..."
})

세션 관리

• sessions_send()로 메시지 전송
• sessions_list()로 상태 확인
• 세션 종료 시 자동 정리

참고 자료

관련 GitHub Issues

• Issue #45868: Subagent sessions_spawn workspace resolution bug
• Issue #23414: mode=“session” requires thread=true (Discord 지원)
• Issue #67785: Nested agent lanes scope fix

플랫폼별 차이

플랫폼	thread 지원	특징
Telegram	❌	세션 유지되나 UI에 안 보임
Discord	✅	스레드로 시각화됨

문제 해결 기록

1차 시도 (실패)

• applicationId 추가 → 스키마 오류
• token만 있으면 될 줄 알았으나 applicationId도 필요

2차 시도 (성공)

• .env 파일에 DISCORD_APPLICATION_ID 추가
• Allowlist를 “서버이름/#채널명” 형식으로 설정
• 게이트웨이 재시작

업데이트 후 주의사항

• 게이트웨이 재시작 필요
• 모든 노드(메인컴, 보조컴) 동일 버전 유지

---

작성: 미미
확인: 미미아빠