Philips Hue 조명을 AI로 제어하기 ― openhue 스킬 사용법
機械翻訳 / Machine-translated
원문 기사: Philips Hue 조명을 AI로 제어하기 ― openhue 스킬 사용법（cccskills）
스킬 페이지: openhue
이 기사의 결론
Philips Hue 조명을 사용하는 분이라면, openhue를 설치하면 조명 제어를 AI 에이전트에게 말로 부탁할 수 있게 됩니다.
부탁할 수 있는 것은 점등·소등, 밝기, 색온도 조정, 방 단위 제어, 씬 전환입니다.
이 기사에서는 요청 예시와 설치 방법, Hue Bridge 및 OpenHue CLI 준비, 불가능한 것까지 순서대로 설명합니다.
**요청을 받은 에이전트가 openhue 명령어를 실행하고, 그 자리에서 조명 상태가 바뀝니다.
** 예를 들어 취침 전이라면 다음과 같이 부탁합니다.
자기 전이니까, 침실 조명을 어둡고 따뜻한 색으로 바꿔줘
이 스킬에는 취침 전용 설정 예시가 준비되어 있습니다.
침실 전체를 밝기 20, 색온도 450으로 점등하는 설정으로, 실행되는 명령어는 다음과 같습니다.
openhue set room "Bedroom" --on --brightness 20 --temperature 450
조명을 하나씩 지정할 필요는 없습니다.
Bedroom 부분에는 방 이름이 들어가며, 그 방의 조명이 한꺼번에 변경됩니다.
openhue는 Hue Bridge를 통해 조명을 제어하는 OpenHue CLI 사용법을 에이전트에게 전달하는 스킬입니다.
GitHub의 openclaw/openclaw에 포함되어 있으며, 내용은 SKILL.md 파일 하나뿐입니다.
제어 단위는 조명, 방, 씬의 세 가지로 나뉩니다.
| 제어 단위 | 부탁할 수 있는 것 |
|---|---|
| 목록 확인 | 조명, 방, 씬의 목록을 표시한다 |
| 조명 | 점등·소등, 밝기（0〜100）, 색온도（153〜500 mirek）, 색상（색 이름 또는 #FF5500 같은 색상 코드） |
| 방 | 방 전체 점등·소등, 밝기, 색온도 |
| 씬 | 등록된 씬을 방을 지정해 활성화한다 |
평소 작업에 대입하면, 구분 방법은 간단합니다.
"이 조명만"이라면 조명 단위, "방 전체"라면 방 단위로 부탁합니다.
평소 분위기로 되돌리고 싶을 때는 Relax나 Concentrate 같은 씬 이름으로 호출하는 방식입니다.
색온도는 빛의 색감을 나타내는 수치이며, mirek은 그 단위입니다.
설정 예시에서 450은 따뜻한 색, 250은 차가운 색에 해당하며, 숫자가 클수록 따뜻한 색감이 됩니다.
스킬 본체 추가는 명령어 실행 또는 에이전트에게 요청하는 방법 중 하나로 완료됩니다.
터미널을 사용할 수 있는 경우, 다음 명령어를 실행하세요.
Claude Code나 Codex 등 설치 대상 에이전트는 실행 시 선택할 수 있습니다.
npx skills add https://github.com/openclaw/openclaw --skill openhue
터미널에 익숙하지 않은 경우, 다음 내용을 에이전트에게 전달하세요.
내용 확인부터 배치까지 맡길 수 있습니다.
次の Agent Skill をインストールしてください。
https://github.com/openclaw/openclaw/tree/main/skills/openhue
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/openhue/、Codex なら ~/.agents/skills/openhue/ に配置してください。
저장 위치는 에이전트와 사용 범위에 따라 달라집니다.
| 에이전트 | 모든 프로젝트에서 사용 | 특정 프로젝트에서 사용 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
**스킬만 설치해서는 조명이 작동하지 않으며, OpenHue CLI와 Hue Bridge 준비가 별도로 필요합니다.
** 다음 순서대로 진행하세요.
OpenHue CLI의 자세한 내용은 OpenHue CLI 페이지에 정리되어 있습니다.
요청 내용에는 대상 방과 어떤 상태로 만들고 싶은지를 적습니다.
자주 사용하는 상황 세 가지를 소개합니다.
침실 조명 전부 꺼줘
침실 전체가 소등되어, 자기 전에 조명을 하나씩 끄는 수고가 없어집니다.
작업실 밝기를 100으로 하고, 색온도를 250으로 해줘
작업실 전체가 밝고 하얀 빛으로 바뀝니다.
집중하고 싶은 시간 전에 부탁하면, 조명 조정을 위해 손을 멈출 필요가 없습니다.
거실을 영화 모드로 해줘
거실 조명이 켜진 채로 밝기 10까지 어두워집니다.
등록된 씬을 사용하고 싶을 때는 "침실에서 Relax 씬을 활성화해줘"처럼 이름으로 부탁하세요.
상황별 설정 예시는 다음 표와 같습니다.
요청 시 수치를 지정할 때의 기준이 됩니다.
| 상황 | 방 예시 | 밝기 | 색온도 | 빛의 느낌 |
|---|---|---|---|---|
| 취침 전 | 침실 | 20 | 450 | 어둡고 따뜻한 색 |
| 업무 | 작업실 | 100 | 250 | 밝은 차가운 색 |
| 영화 | 거실 | 10 | 지정 없음 | 어두운 느낌 |
방이나 씬의 이름을 모를 때는 "방 목록을 보여줘", "씬 목록을 보여줘"라고 부탁하세요.
등록된 이름은 OpenHue CLI의 목록 표시로 확인할 수 있습니다.
사용 전에 전구 종류와 제어 불가 기기를 확인하세요.
색상 지정이 반영되는 것은 컬러 지원 전구뿐이며, 흰색 전용 전구에서는 색을 변경할 수 없습니다.
다음 기기와 기능도 이 스킬로는 제어할 수 없습니다.
가족과 공유하는 조명에서는 제어 범위에 주의하세요.
방 단위로 부탁하면 그 방의 조명이 모두 변경됩니다.
누군가 사용 중인 방에서는 조명 이름을 지정해 범위를 좁히면 안심할 수 있습니다.
라이선스는 MIT입니다.
설치 전에 SKILL.md 내용을 읽고, 어떤 명령어가 실행되는지 확인하세요.
포함된 파일은 하나뿐이므로, 확인 부담이 적습니다.
조명 외의 기기도 에이전트에게 맡기고 싶다면, 다음 두 가지를 같은 상황에서 사용할 수 있습니다.
sonoscli는 로컬 네트워크상의 Sonos 스피커의 재생·정지·음량을 제어하는 스킬입니다.
조명을 끄고 나서 음악을 트는 흐름으로 조합할 수 있습니다.
eightctl은 Eight Sleep Pod의 상태 확인, 전원, 온도 조정을 부탁할 수 있는 스킬입니다.
침실 조명을 어둡게 하는 것과 같은 타이밍에 침구 설정도 변경할 수 있습니다.
사용할 수 없습니다.
openhue는 Hue Bridge를 통해 조명을 제어하므로, Bridge가 로컬 네트워크상에 있는 것이 조건입니다.
색상 변경에는 사용할 수 없습니다.
색상 지정이 반영되는 것은 컬러 지원 전구뿐이므로, 먼저 현재 사용 중인 전구의 종류를 확인하세요.
스케줄을 설정하는 명령어는 이 스킬에 포함되어 있지 않습니다.
다루는 것은 목록 확인과 조명, 방, 씬의 제어입니다.
요청을 받았을 때 조명을 변경하는 방식으로 사용합니다.
호출할 수 없습니다.
HomeKit 씬 및 단축어는 대상 외이며, Apple의 홈 앱 또는 단축어를 사용합니다.
openhue는 Philips Hue의 점등·소등, 밝기, 색상, 색온도, 방 단위 제어, 씬 전환을 에이전트에게 맡기는 스킬입니다.
작동시키려면 OpenHue CLI와 Hue Bridge가 필요하며, 처음 사용 시 Bridge의 버튼을 눌러 페어링합니다.
준비가 완료되면 먼저 방 목록을 확인하고, 침실 소등부터 시도해 보세요.
설치 명령어와 소개 내용은 cccskills 페이지에서 확인할 수 있습니다.
이 기사는 cccskills의 읽을거리 「Philips Hue 조명을 AI로 제어하기 ― openhue 스킬 사용법」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 openhue 페이지에 있습니다.