cr8rcho
튜토리얼

OpenClaw 2026.3.2 업데이트 후 tools 설정 변경 정리

3월 8일
3 분

OpenClaw 2026.3.2 업데이트 후 tools 설정 변경 정리

OpenClaw 2026.3.2 업데이트에서 tools 관련 설정 구조가 변경되었다. 이전에 exec 승인 해제를 위해 여러 곳에 분산되어 있던 설정이 하나로 정리되면서, 기존 설정 일부를 제거하고 새로운 구조로 마이그레이션해야 한다.

이 글에서는 무엇이 바뀌었고, 현재 어떻게 설정하면 되는지 정리한다.

가장 큰 변경: tools.profile 기본값이 messaging

2026.3.2의 브레이킹 체인지 중 가장 중요한 것은 온보딩 시 tools.profilemessaging으로 기본 설정된다는 점이다. 새로 설치하면 코딩이나 시스템 도구 없이 메시징 도구만 활성화된 상태로 시작한다.

기존 사용자가 업데이트하면 이 tools.profile: "messaging" 설정이 남아있을 수 있는데, 코딩/시스템 도구를 쓰려면 이 profile 설정을 제거해야 한다.

{
  "tools": {
    "profile": "messaging"
  }
}

이 설정이 있으면 exec, 파일 편집 등 대부분의 도구가 비활성화된다. 전체 도구를 사용하려면 tools.profile 자체를 삭제하면 된다.

이전 설정 (2026.3.2 이전)

exec 명령을 승인 없이 실행하려면 세 가지 설정을 건드려야 했다:

{
  "approvals": {
    "exec": {
      "enabled": false
    }
  },
  "tools": {
    "elevated": {
      "enabled": false
    }
  },
  "channels": {
    "discord": {
      "execApprovals": null
    }
  }
}

tools.elevated는 elevated 권한 도구 사용 여부를 제어했고, channels.discord.execApprovals는 Discord 채널별 exec 승인 설정이었다. 이 세 가지가 서로 우선순위가 엮여 있어서, 하나만 빠뜨려도 승인 요청이 발생했다.

변경된 설정 (2026.3.2 이후)

2026.3.2에서 profile messaging이 tools에서 분리되면서, tools.elevated 섹션이 제거되었다. channels.discord.execApprovals도 더 이상 필요하지 않다.

현재 필요한 설정:

{
  "tools": {
    "exec": {
      "security": "full",
      "ask": "off"
    }
  },
  "approvals": {
    "exec": {
      "enabled": false
    }
  }
}

각 설정의 의미

  • tools.exec.security: "full" — 모든 셸 명령을 제한 없이 실행 허용
  • tools.exec.ask: "off" — exec 실행 시 확인 질문 비활성화
  • approvals.exec.enabled: false — 전역 exec 승인 비활성화

마이그레이션 방법

기존 설정에서 제거해야 할 항목:

  1. tools.profile 삭제 (messaging으로 설정되어 있으면 도구 제한됨)
  2. tools.elevated 섹션 전체 삭제
  3. channels.discord.execApprovals 삭제

추가해야 할 항목:

openclaw configure --patch '{"tools":{"exec":{"security":"full","ask":"off"}}}'
openclaw gateway restart

approvals.exec.enabled: false는 이전과 동일하게 유지하면 된다.

정리

항목이전현재
tools.profile없음"messaging" 기본값 (삭제 필요)
tools.elevated.enabledfalse 필요제거됨
channels.discord.execApprovalsnull 필요제거됨
tools.exec.security없음"full"
tools.exec.ask없음"off"
approvals.exec.enabledfalsefalse (동일)

설정이 tools.exec 하나로 통합되면서 훨씬 깔끔해졌다. 업데이트 후 이전 설정이 남아있어도 동작에 문제는 없지만, 불필요한 설정은 정리해두는 게 좋다.