https://playbooks.com/skills/openclaw/skills/samsung-smartthings




따끈따끈한 스마트싱스의 OAuth 통합 사용한 방식임






이 스킬을 사용하면 자격 증명을 프로비저닝하고, 장치를 검색하고, 기본 명령을 전송하여 SmartThings OAuth를 통해 삼성 TV를 안전하게 제어할 수 있습니다.

npx playbooks add skill openclaw/skills --skill samsung-smartthings

아래 파일을 검토하거나 위의 명령어를 복사하여 에이전트에 이 스킬을 추가하세요.



개요

이 스킬을 사용하면 OAuth 앱을 프로비저닝하고 에이전트 자격 증명을 저장하여 SmartThings 플랫폼을 통해 삼성 스마트 TV를 제어할 수 있습니다. 앱 생성을 자동화하고, OAuth 코드를 토큰으로 교환하며, 장치 구성을 저장하여 에이전트가 전원, 볼륨, 음소거 및 앱 실행과 같은 명령을 전송할 수 있도록 합니다. 기본적으로 헤드리스 모드로 설정되지만 필요한 경우 수동으로 앱을 생성할 수도 있습니다.

이 스킬은 어떻게 작동하나요?

이 스킬은 SmartThings CLI를 통해 SmartThings PAT를 사용하여 앱을 프로비저닝하거나 미리 생성된 클라이언트 자격 증명을 수락하여 필요한 읽기 및 실행 권한을 가진 OAuth-In 스마트 앱을 생성합니다. 인증 코드를 얻기 위해 휴대폰 로그인 URL을 출력하고, 해당 코드를 SmartThings와 직접 교환하여 액세스 토큰과 새로 고침 토큰을 발급받은 후, 앱 ID, 클라이언트 ID/시크릿, 장치 ID 및 토큰을 영구적인 .env 상태 디렉터리에 기록합니다. 장치 제어는 SmartThings 장치 명령 API를 호출하거나 SmartThings CLI를 사용하여 장치를 검색하고 상태를 확인하는 방식으로 수행됩니다.

언제 사용해야 할까요?
  • SmartThings를 통해 연동된 삼성 TV에 대한 헤드리스 OAuth 프로비저닝을 설정합니다.
  • 장기 실행 에이전트에 대한 SmartThings OAuth 자격 증명을 저장하고 갱신합니다.
  • 반복적인 제어 작업을 위해 TV 장치 ID를 검색하고 저장하십시오.
  • SmartThings를 통해 전원, 볼륨, 음소거 또는 앱 실행 명령을 전송하세요.
  • TV에서 특정 스트리밍 앱을 실행하는 데 필요한 앱 ID를 찾아보세요.
모범 사례
  • 수동 CLI 로그인 절차를 피하기 위해 헤드리스 앱 생성을 위한 SmartThings PAT를 제공하십시오.
  • PAT 생성에 실패할 경우, 일반 컴퓨터에서 OAuth 앱을 생성한 다음 인증 코드를 교환하기 전에 에이전트 상태에서 클라이언트 ID/시크릿을 설정하십시오.
  • 인쇄된 로그인 URL은 항상 본인이 관리하는 휴대폰이나 브라우저에서 열고, 코드 쿼리 매개변수만 복사하여 설정 과정에 다시 붙여넣으세요.
  • SmartThings CLI를 사용하여 기기 목록을 JSON 형식으로 확인하고 TV 기기 ID를 검증하세요. 검증된 ID를 동일한 .env 파일에 저장하여 반복적으로 명령을 실행할 수 있도록 합니다.
  • 앱 ID를 확인할 때는 먼저 TV에서 대상 앱을 열고 기기 상태를 조회하여 정확한 앱 ID 값을 얻으세요.
예시 사용 사례
  • 대화형 브라우저 없이 스마트홈 자동화 에이전트용 SmartThings OAuth 자격 증명을 제공합니다.
  • 삼성 TV 기기 ID를 등록하고 저장해 두면 리모컨으로 볼륨과 전원을 제어할 수 있습니다.
  • Netflix 또는 Prime Video 앱 ID를 검색하고 저장하여 앱을 자동으로 실행하세요.
  • TV 기기의 상태와 기능을 확인하여 앱 실행 또는 직접 명령 지원 여부를 판단하십시오.
  • 토큰을 새로 고치려면 설정 프로그램을 다시 실행하여 저장된 자격 증명을 업데이트하십시오.
자주 묻는 질문

앱 생성 시 PAT와 함께 403 오류가 발생하면 어떻게 해야 할까요?

SmartThings CLI를 사용하여 일반 컴퓨터에서 대화형 로그인 방식으로 OAuth 앱을 생성한 다음, 클라이언트 ID와 시크릿을 에이전트 상태에 복사한 후 코드 교환을 계속 진행하십시오.

특정 스트리밍 앱의 앱 ID를 어떻게 확인할 수 있나요?

TV에서 앱을 열고 기기 상태를 확인한 다음, supportedApps, installedApps, tvChannelName 등의 필드를 검사하여 현재 앱 ID를 추출하고 나중에 사용할 수 있도록 저장하세요.