FoneClaw 무료 YouTube 다운로더 플러그인: 로컬 Android 다운로드 흐름

무료 로컬 YouTube 다운로더 플러그인이 할 수 있는 일

2026년 8월 2일 기준으로 FoneClaw는 무료이며 사용량을 차감하는 결제 단위가 없습니다. FoneClaw YouTube Downloader도 완전히 무료인 로컬 플러그인 도구입니다. 이 플러그인은 사용자가 입력하거나 공유한 YouTube URL을 FoneClaw 서비스로 업로드하지 않습니다. 다만 다운로드 과정에서 YouTube와 Android 기기의 네트워크를 사용하므로, 통신사 데이터 요금이나 네트워크 사용량까지 무료라는 뜻은 아닙니다.

시작 방법은 두 가지입니다. 사용자는 YouTube 앱에서 지원되는 영상 링크를 FoneClaw로 공유할 수 있고, FoneClaw 안에 영상 URL을 직접 입력하거나 붙여 넣을 수도 있습니다. 두 경로 모두 같은 플러그인 흐름으로 이어집니다. FoneClaw가 URL을 인식하고, plugin_youtube_video_info로 공개 metadata와 사용 가능한 format을 확인한 뒤, 사용자가 원하는 option을 선택하고 결과가 생기는 작업을 승인하면 다운로드가 시작됩니다.

FoneClaw Android repository에서 확인되는 YouTube Downloader surface는 video info, download, status, cancel로 나뉩니다. 이 기능은 FoneClaw의 built-in tools에 포함된 기본 도구가 아니라 signed package trust 흐름을 거치는 plugin입니다. YouTube 재생, 검색, 자막, 후속 작업을 음성으로 다루는 사용 intent라면 YouTube 음성 제어 Android 가이드: 검색, 재생, 자막, 후속 작업이 별도 목적에 더 맞습니다.

이 플러그인은 사용자가 내려받을 권리가 있는 콘텐츠에 맞춰 써야 합니다. FoneClaw는 보호된 콘텐츠를 우회하거나, 모든 영상과 모든 품질을 무제한 지원한다고 말하지 않습니다. 우리 제품 범위는 모델이 요청을 이해하고, 로컬 플러그인 도구가 검증된 경로에서 작업을 수행하며, Android 효과가 승인과 상태 표시 안에서 관리되도록 하는 것입니다.

signed package trust 흐름으로 플러그인 설치하기

플러그인 설치에서 가장 중요한 질문은 “어디서 받았는가”와 “무엇을 등록하는가”입니다. YouTube Downloader는 built-in tool이 아니므로, FoneClaw 안에서 보이는 plugin proposal과 trusted package flow를 통해 다뤄야 합니다. 검증된 흐름은 signed GitHub-delivered package와 trusted fingerprint 확인을 전제로 합니다. GitHub에 asset이 있다는 사실만으로 자동 신뢰가 생기는 것은 아니며, package identity와 fingerprint가 기대한 값과 맞아야 registration 단계로 넘어갈 수 있습니다.

설치와 등록은 다른 상태입니다. 설치는 Android에 package가 들어오는 과정이고, registration은 FoneClaw agent runtime이 해당 plugin tool surface를 인식하고 사용할 준비를 하는 과정입니다. 사용자는 제안된 package 이름, source, signature 또는 fingerprint 신뢰 상태, plugin이 노출하는 tool IDs를 확인해야 합니다. 임의 APK를 내려받아 설치하거나, 출처가 불분명한 package를 trusted plugin처럼 등록하는 방식은 FoneClaw의 플러그인 신뢰 모델에 맞지 않습니다.

실무적으로는 다음 순서가 안전합니다. 먼저 FoneClaw에서 plugin proposal을 확인합니다. 다음으로 package source와 fingerprint trust를 봅니다. 그다음 설치 후 plugin registration 상태를 확인하고, video info 같은 낮은 위험 read tool이 보이는지 확인합니다. plugin이나 skill package의 신뢰와 실행 중 권한 검사를 더 넓게 보고 싶다면 AI 에이전트 스킬 보안: 검사 통과보다 실행 중 권한 확인이 중요한 이유가 배경을 제공합니다.

FoneClaw 0.1.0은 Agent task flow, permission recovery, failure handling을 개선했습니다. 다만 이 release fact는 플러그인이 core release에 bundled 되었다는 뜻이 아닙니다. built-in tools와 plugins는 서로 다른 evidence class로 다루어야 하며, 플러그인은 설치 제안, package trust, registration, tool policy를 각각 확인한 뒤 써야 합니다.

공개 metadata를 확인하고 정확한 format 고르기

Android에서 YouTube 동영상 다운로드를 시작하기 전에는 파일 작업을 만들지 않는 read-only 확인이 먼저입니다. plugin_youtube_video_info는 LOW risk와 AUTO approval 정책을 가진 정보 조회 도구입니다. 이 도구는 YouTube URL의 공개 metadata와 사용 가능한 format choices를 로컬 플러그인 흐름에서 확인하며, 그 자체로 파일을 만들거나 다운로드 job을 시작하지 않습니다.

이 단계의 목적은 사용자가 정확히 무엇을 내려받을지 정하는 것입니다. 영상인지 audio인지, 어떤 품질이 실제로 제공되는지, 선택한 format이 사용자의 목적에 맞는지 확인해야 합니다. 중요한 점은 “원하는 format”과 “available format”이 다를 수 있다는 사실입니다. 플러그인은 모든 format이 항상 있다고 약속하지 않으며, 다운로드 단계에서 조용히 다른 품질로 downgrade하는 흐름을 제품 가치로 삼지 않습니다.

format 선택 전에는 다음 항목을 짧게 확인하는 것이 좋습니다.

• 콘텐츠: 제목과 공개 metadata가 사용자가 의도한 YouTube 항목과 맞는지 확인합니다.
• 입력 경로: YouTube에서 FoneClaw로 공유한 링크인지, FoneClaw에 직접 입력하거나 붙여 넣은 URL인지 확인합니다.
• 목적: video가 필요한지, audio가 충분한지 정합니다.
• format: plugin_youtube_video_info가 반환한 choices 안에서 exact format을 고릅니다.
• 저장 기대: 현재 검증된 delivery boundary를 이해하고, 임의 folder나 모든 기기 동작을 가정하지 않습니다.
• 권리: 다운로드가 허용된 콘텐츠인지, platform terms와 권리 범위를 확인합니다.

이 과정을 거치면 사용자는 다운로드 승인 화면에서 무엇을 승인하는지 더 명확히 알 수 있습니다. 모델이 “좋아 보이는 품질로 받아 둘게요”라고 계획하는 것보다, 사용 가능한 format을 먼저 보고 exact choice를 고르는 쪽이 FoneClaw의 도구 경계에 맞습니다.

외부 효과가 있는 다운로드는 명시적 승인으로 시작합니다

plugin_youtube_download는 파일 생성과 네트워크 작업을 일으키는 도구입니다. 그래서 이 tool은 EXTERNAL_EFFECT이고 REQUIRE_APPROVAL 정책을 가집니다. 사용자가 metadata를 확인하고 exact format을 고른 뒤에도, 실제 Android에서 YouTube 다운로드 작업을 시작하기 전에는 명시적 승인이 필요합니다. 이 승인은 사용자가 파일 생성, 네트워크 사용, 저장 결과를 이해하고 시작하는 경계입니다.

“자동 다운로드”는 FoneClaw가 사용자의 선택과 승인 이후에 필요한 단계를 이어서 수행한다는 뜻입니다. FoneClaw가 URL을 인식하고, 플러그인으로 정보를 확인하고, 사용자가 선택한 format과 승인 내용을 바탕으로 job을 시작하고 추적합니다. 이 표현은 format 선택, 권한 확인, 결과가 생기는 작업의 승인을 건너뛴다는 뜻이 아닙니다.

다운로드 흐름은 한 번만 번호로 정리하면 충분합니다.

1. 사용자가 YouTube에서 지원되는 영상 링크를 FoneClaw로 공유하거나, FoneClaw에 URL을 직접 입력하거나 붙여 넣습니다.
2. FoneClaw가 URL을 인식하고 plugin_youtube_video_info로 공개 metadata와 available formats를 확인합니다.
3. 사용자가 video 또는 audio 목적과 exact available format을 선택합니다.
4. FoneClaw가 plugin_youtube_download 요청 내용을 보여 주고, EXTERNAL_EFFECT approval을 받습니다.
5. 승인 후 download tool은 선택한 exact format으로 job을 시작합니다.
6. 성공적으로 시작되면 jobId가 반환되고, Android foreground service가 진행 중 작업을 보이게 처리합니다.
7. 같은 항목의 중복 job이 생기지 않도록 duplicate prevention 흐름이 적용됩니다.

이 설계에서 중요한 것은 silent downgrade가 없다는 점입니다. 사용자가 선택한 format이 실행 단위가 되어야 하며, 사용할 수 없는 format이면 다른 format을 임의로 고르기보다 다시 확인해야 합니다. 또한 jobId는 단순한 내부 id가 아니라 사용자가 진행 상태와 취소 요청을 구분하는 기준입니다.

다운로드와 취소는 승인 성격이 다릅니다. 시작은 외부 효과가 있는 파일 작업이고, 취소는 진행 중 device control에 가까운 작업입니다. 이런 tool boundary와 감사 로그 기준을 더 깊게 보려면 AI 에이전트 신원과 권한: 도구별 승인 제어와 감사 로그 설계가 왜 action마다 기록과 승인 정책이 달라지는지 설명합니다.

jobId로 다운로드를 추적하고 취소하고 진단하기

다운로드가 시작되면 사용자는 jobId로 상태를 확인할 수 있어야 합니다. plugin_youtube_download_status는 LOW risk와 AUTO approval 정책을 가진 상태 조회 도구입니다. 이 도구는 파일을 새로 만들거나 작업을 바꾸지 않고, 특정 job이 queued, running, completed, failed, canceled 중 어디에 있는지 확인하는 데 쓰입니다. Android YouTube 다운로더 플러그인을 실용적으로 쓰려면 이 상태 조회가 다운로드 시작만큼 중요합니다.

취소는 별도 경계입니다. plugin_youtube_download_cancel은 DEVICE_CONTROL이고 REQUIRE_APPROVAL 정책을 가집니다. 사용자가 취소하려는 jobId가 맞는지 확인해야 하며, cancel request가 들어갔다고 해서 모든 기기와 모든 상태에서 partial artifact가 완벽히 제거된다고 말할 수는 없습니다. 네트워크 상태, Android storage behavior, foreground service 상태, 이미 완료된 파일 처리 방식은 broader validation이 필요한 영역입니다.

문제가 생겼을 때는 원인을 좁혀야 합니다. metadata 조회는 성공했지만 다운로드가 시작되지 않았다면 format 선택이나 approval boundary를 봅니다. jobId는 받았지만 진행이 멈췄다면 network, foreground service, storage 상태를 확인합니다. 취소했는데 파일 흔적이 보인다면 completed state였는지, partial artifact인지, MediaStore 반영 상태인지 구분해야 합니다. FoneClaw 0.1.0의 permission recovery와 failure handling 개선은 이런 상황에서 다음 행동을 더 분명히 안내하는 방향입니다.

좋은 recovery는 과한 약속보다 관찰 가능한 상태를 제공합니다. 어떤 jobId가 어떤 요청에서 만들어졌는지, 어떤 format을 선택했는지, 승인 여부가 무엇이었는지, 현재 상태가 무엇인지, 사용자가 다시 시도할지 취소할지 확인할 수 있어야 합니다. 다운로드 작업은 작은 편의 기능처럼 보이지만, 실제로는 네트워크, storage, foreground execution, plugin policy가 만나는 Android 작업입니다.

현재 파일 전달 방식과 추가 검증이 필요한 범위

파일이 어디에 저장되는지는 가장 많이 나오는 질문이지만, 여기서는 검증된 범위만 정확히 말해야 합니다. 현재 validated path는 Android MediaStore를 통한 360p delivery입니다. 즉 360p format으로 성공적으로 전달되는 경로가 검증되어 있으며, 임의 folder 이름이나 모든 Android 기기에서 동일한 표시 방식을 단정하지 않습니다.

MediaStore는 Android에서 media file이 system media collection에 반영되는 경로입니다. 사용자는 결과 파일이 Android의 media handling 안에서 보일 것을 기대할 수 있지만, 앱별 표시 위치, 파일 관리 앱에서 보이는 방식, 기기 제조사별 media scan 동작은 차이가 날 수 있습니다. 따라서 “항상 특정 폴더에 저장된다”는 표현보다 “현재 검증된 360p MediaStore delivery”라고 말하는 것이 정확합니다.

아직 더 넓은 검증이 필요한 영역도 분명합니다. broader formats가 모든 기기에서 같은 방식으로 되는지, cancellation recovery가 partial files를 어떻게 처리하는지, storage behavior가 Android 버전과 제조사별로 어떻게 달라지는지, device matrix가 어디까지인지, license validation을 어떤 방식으로 사용자에게 보여 줄지는 추가 확인이 필요합니다. 이 글에서는 플러그인의 현재 검증 경계를 넘기지 않습니다.

FoneClaw의 built-in catalog에는 100+ built-in tools가 있지만, 이 YouTube Downloader는 그 count 안에 들어가는 built-in tool이 아닙니다. plugin execution, Android effect, MediaStore delivery를 별도 layer로 봐야 사용자는 어떤 결과가 검증됐고 어떤 부분을 직접 확인해야 하는지 알 수 있습니다.

허용된 콘텐츠를 사용자 통제 아래 다루는 체크리스트

Android에서 YouTube 동영상 다운로드는 편의보다 권리와 통제가 먼저입니다. YouTube Terms of Service와 콘텐츠 권리, creator permission, local law를 고려해야 하며, FoneClaw는 보호된 콘텐츠를 우회하거나 허가되지 않은 다운로드를 안내하는 제품이 아닙니다. 사용자는 자신이 내려받을 수 있는 콘텐츠인지 먼저 확인하고, 그다음 plugin trust와 format, approval, result를 확인해야 합니다.

• 권리 확인: 직접 소유했거나 허용된 콘텐츠인지, 플랫폼 terms와 creator permission에 맞는지 봅니다.
• 입력 경로 확인: YouTube에서 FoneClaw로 공유하거나, FoneClaw에 URL을 직접 입력하거나 붙여 넣습니다.
• 로컬 처리 확인: 이 무료 플러그인 도구는 YouTube URL을 FoneClaw 서비스로 업로드하지 않습니다.
• 출처 확인: signed GitHub-delivered package와 trusted fingerprint 흐름을 거칩니다.
• metadata 확인: plugin_youtube_video_info로 제목과 available formats를 먼저 확인합니다.
• format 확정: video 또는 audio 목적과 exact available format을 사용자가 고릅니다.
• 승인 확인: plugin_youtube_download의 EXTERNAL_EFFECT approval을 보고 시작합니다.
• 상태 추적: jobId로 status를 확인하고, 필요하면 cancel tool을 승인해 취소합니다.
• 결과 검증: 현재 검증된 360p MediaStore delivery 범위 안에서 파일이 보이는지 확인합니다.

FoneClaw는 free default model로 시작할 수 있고, 사용자가 compatible model을 구성해 agent reasoning을 맡길 수도 있습니다. 어느 쪽이든 모델은 요청을 이해하고 계획하며, 실제 plugin tool execution과 Android effects는 tool policy와 user approval 아래 움직입니다. 이 글의 실전 기준은 분명합니다. built-in tool과 plugin을 구분하고, URL 공유와 직접 입력 경로를 모두 이해하고, exact format을 고르고, 외부 효과를 승인하고, jobId로 추적하며, 허용된 콘텐츠만 다루는 것입니다.