OpenClaw macOS 스킬 설정 및 관리 가이드

새로운 툴을 설치할 때마다 로컬 환경이 꼬이는 경험, 다들 한 번쯤은 있으시죠? 설정 파일은 어디에 있는지, 의존성은 왜 자꾸 깨지는지 파악하다 보면 정작 중요한 작업은 시작도 못 하기 일쑤예요.

macOS용 OpenClaw는 이런 번거로움을 줄이기 위해 스킬 관리 방식을 최적화했어요. 복잡한 로컬 설정 대신 Gateway를 활용해 더 깔끔하고 안전하게 스킬을 다루는 방법을 알아볼게요.

데이터 소스

macOS 앱은 Gateway를 통해 OpenClaw 스킬을 보여줘요. 앱이 로컬에서 직접 스킬을 파싱하는 방식이 아니에요.

• Gateway의 skills.status가 모든 스킬 정보와 함께 설치 가능 여부, 누락된 요구 사항을 반환해요. 여기에는 번들 스킬에 대한 allowlist 차단 여부도 포함돼요.
• 각 스킬의 요구 사항은 SKILL.md 파일에 작성된 metadata.openclaw.requires 데이터를 기반으로 확인해요.

설치 작업

스킬 설치는 정의된 규칙에 따라 체계적으로 진행돼요.

• metadata.openclaw.install 섹션에 설치 옵션(brew/node/go/uv)을 정의해요.
• 앱이 skills.install을 호출하면 Gateway 호스트에서 설치 프로그램이 실행돼요.
• 보안을 위해 빌트인 코드 검사에서 critical 위험 요소가 발견되면 기본적으로 skills.install 작업이 차단돼요. 의심스러운 수준의 발견 사항은 경고만 표시하고요. Gateway 요청 시 이 차단 설정을 무시할 수도 있지만, 앱의 기본 흐름은 안전을 위해 실패로 처리하는 방식을 유지해요.
• 설치 옵션이 여러 개라면 Gateway는 가장 적합한 설치 도구 하나만 노출해요. brew를 사용할 수 있다면 brew를 우선하고, 그렇지 않으면 skills.install에 지정된 Node.js 매니저(기본값 npm)를 선택해요.

환경 변수 및 API 키

보안이 중요한 키 정보는 정해진 위치에 안전하게 보관돼요.

• 앱은 API 키와 설정 정보를 ~/.openclaw/openclaw.json 파일의 skills.entries.<skillKey> 항목에 저장해요.
• skills.update 명령을 사용하면 enabled, apiKey, env 설정을 수정할 수 있어요.

원격 모드

이 모든 과정에서 기억해야 할 핵심은 실행 위치예요. 스킬의 설치와 설정 업데이트는 로컬 Mac이 아니라 Gateway 호스트에서 직접 이루어져요. 덕분에 로컬 환경을 깨끗하게 유지하면서도 필요한 기능을 자유롭게 확장할 수 있어요.

---

다음 단계:

• Gateway 설정 가이드
• SKILL.md 작성법

AI Setup Assistant