Бесплатный FoneClaw и локальный плагин загрузки YouTube на Android

Что именно делает бесплатный локальный плагин

Короткий ответ на 2 августа 2026 года: FoneClaw бесплатен, а плагин загрузки YouTube для FoneClaw — полностью бесплатный локальный plugin tool. В FoneClaw нет системы платных единиц использования. Плагин работает локально в workflow FoneClaw и не отправляет YouTube URL в сервисы FoneClaw. При этом сама загрузка остается сетевым действием: интернет-доступ, мобильный трафик, ограничения сети и правила YouTube не становятся бесплатными или отмененными из-за того, что plugin локальный.

Запустить workflow можно двумя поддерживаемыми путями. Первый: открыть поддерживаемый ролик в YouTube и поделиться ссылкой в FoneClaw через системное Android-меню. Второй: ввести или вставить URL видео прямо в FoneClaw. В обоих случаях FoneClaw распознает ссылку, использует plugin для проверки публичных metadata и доступных форматов, просит пользователя выбрать нужный вариант, затем запрашивает approval для consequential action и только после этого стартует download job.

Важно правильно назвать слой. FoneClaw — Android phone-agent runtime, который может использовать бесплатную default model или настроенную совместимую модель для понимания запроса и планирования. YouTube Downloader — отдельный plugin surface, который добавляет конкретные plugin tools: video info, download, status и cancel. Built-in tools FoneClaw и plugin tools имеют разный путь доверия, поэтому их нельзя смешивать в одном списке возможностей.

Если ваша задача — голосом искать, открывать или управлять воспроизведением YouTube на Android, это другой intent; для него полезнее материал Голосовое управление YouTube на Android: поиск, видео и действия. Здесь мы разбираем именно download workflow: от доверенной установки до проверки результата. Используйте его только для контента, который вы вправе скачивать, с учетом прав автора, локальных правил и условий YouTube.

Основная текущая граница такая: verified repository path подтверждает plugin behavior, signed package trust, exact format selection, approval, jobId, foreground execution, duplicate prevention и 360p delivery through Android MediaStore. Он не превращает один проверенный путь в универсальную поддержку всех устройств, форматов, сетей и recovery cases.

Как установить signed plugin через доверенный package flow

Установка plugin должна начинаться не с произвольного APK, а с видимой plugin proposal внутри FoneClaw. Пользователь должен понимать, какой plugin предлагается, откуда берется package, какой fingerprint или trust signal проверяется, какие tools появятся после регистрации и какое действие он сможет выполнять. Установка и регистрация — разные состояния: package может быть получен, но plugin еще не должен считаться готовым к выполнению tools, пока identity и trust не проверены.

Проверенный путь для YouTube Downloader использует signed GitHub-delivered package и trusted fingerprint flow, описанный в репозитории FoneClaw Android. Это не означает, что любой GitHub asset автоматически доверенный. Доверенным является конкретный путь, где package identity, signature или fingerprint и plugin registration проходят ожидаемую проверку. Если источник, имя package, fingerprint или версия не совпадают с ожидаемыми данными, установку нужно остановить до регистрации.

Практическая последовательность установки должна быть короткой и проверяемой:

1. Откройте plugin proposal внутри FoneClaw, а не сторонний установщик.
2. Проверьте название plugin, источник package и trust signal, которые показывает runtime.
3. Подтвердите установку только после проверки package identity.
4. Дождитесь отдельного состояния plugin registration, где tools становятся видимыми для агента.
5. Перед первой загрузкой выполните read-only проверку metadata, а не сразу download.

Такой порядок защищает от двух частых ошибок. Первая — считать установку файла уже разрешением на действия. Вторая — доверять plugin только потому, что он связан с нужной функцией. Для более широкой модели доверия к skills, plugins и Android permissions полезен материал Безопасность навыков AI-агентов: почему телефону нужны проверки разрешений. В этом walkthrough мы остаемся в конкретном plugin path: proposal, signed package, trusted fingerprint, registration, затем controlled tool use.

Как передать ссылку, проверить metadata и выбрать формат

Перед тем как скачать видео YouTube на Android, FoneClaw должен сначала получить информацию о ролике. Ссылка может прийти из системного действия Share в YouTube или быть введена либо вставлена пользователем прямо в FoneClaw. В обоих случаях FoneClaw распознает URL локально в workflow и использует plugin_youtube_video_info. Это LOW risk tool с AUTO approval: он возвращает public metadata и format choices, но не создает файл, не запускает foreground download и не меняет состояние устройства.

На этом шаге пользователь должен увидеть не абстрактную кнопку «скачать», а конкретный выбор. Какие форматы доступны для данного URL? Есть ли видео-вариант? Есть ли audio-only вариант? Какое качество доступно именно сейчас? Какой вариант соответствует цели: сохранить ролик для просмотра, получить аудио для разрешенного личного использования или проверить, что файл вообще можно доставить через текущий validated path? Plugin не должен придумывать format list и не должен обещать формат, которого нет в metadata.

Хороший выбор формата состоит из четырех проверок. Во-первых, убедитесь, что URL указывает на нужный ролик. Во-вторых, проверьте title или другую public metadata, чтобы не скачать неверный контент. В-третьих, выберите exact available format, а не общую просьбу «лучшее качество». В-четвертых, заранее решите, нужен ли видеофайл или аудио-вариант, если такой вариант реально присутствует в choices.

Это особенно важно из-за current-validation boundary. Verified path подтверждает точный форматный workflow и 360p MediaStore delivery, но не превращает все возможные YouTube qualities в поддерживаемые на каждом устройстве. Если пользователь выбрал формат, который отсутствует, агент должен вернуть понятный отказ или предложить выбрать из доступных options. Silent downgrade в download step недопустим: если пользователь выбрал один format, plugin_youtube_download должен работать именно с ним или остановиться с объяснением.

На практике этот шаг экономит время и делает approval осмысленным. Пользователь подтверждает не «какую-то загрузку», а конкретный ролик, конкретный type, конкретное quality choice и ожидаемое file delivery behavior. Для phone-agent UX это принципиально: внешнее действие должно быть понятно до запуска, а не только после появления файла.

Как запустить загрузку с явным external-effect approval

Загрузка — это уже не read-only inspection. plugin_youtube_download относится к EXTERNAL_EFFECT и REQUIRE_APPROVAL, потому что он запускает сетевую операцию, foreground execution и создание файла на устройстве. Поэтому approval boundary должен быть явным: FoneClaw показывает пользователю, что именно будет скачано, какой exact format выбран, что будет создан файл и что операция получит jobId для дальнейшего отслеживания.

Перед подтверждением пользователь должен увидеть минимум четыре вещи: источник видео, выбранный формат, ожидаемый тип результата и факт, что действие начнет download job. Если эти данные не совпадают с ожиданием, нужно вернуться к video info step. Если совпадают, пользователь подтверждает именно external-effect tool, а не просто продолжение разговора с моделью. Это различие разобрано глубже в статье Идентичность ИИ-агента: разрешения, аудит и подтверждение инструментов, потому что download и cancel имеют разные risk policies и разные записи в audit trail.

Фраза «автоматическая загрузка» в FoneClaw означает не обход выбора и approval, а выполнение workflow после них. Сначала FoneClaw распознает ссылку, затем plugin читает публичные metadata и format choices, потом пользователь выбирает вариант и подтверждает consequential action. Только после этого FoneClaw запускает download, ведет foreground job, возвращает jobId и отслеживает состояние. Если выбора или подтверждения нет, automatic download не стартует.

После успешного старта tool возвращает jobId. jobId нужен не для красоты, а для отделения одной загрузки от другой: по нему status tool понимает, какой job проверять, а cancel tool — какой job останавливать. Если пользователь повторно просит скачать тот же ролик в том же формате, duplicate prevention должен не создавать второй одинаковый background task, а показать текущий job или объяснить, что такая операция уже идет.

Foreground service важен для Android-опыта. Пользователь должен понимать, что загрузка продолжается в видимом системном контексте, а не исчезла в фоне без следа. При нестабильной сети, нехватке места, изменении разрешений или сбое plugin не должен имитировать успешное завершение. Правильный результат start step — это либо jobId и running state, либо понятная ошибка до начала внешнего эффекта.

Эта таблица показывает, почему один plugin не имеет одной политики на все действия. Info и status только читают состояние. Download создает внешний эффект. Cancel управляет устройственным процессом. Поэтому подтверждение по инструментам должно быть привязано к конкретному tool, а не к названию plugin.

Как отслеживать, отменять и диагностировать download job

После старта загрузки главным идентификатором становится jobId. Для проверки прогресса используется plugin_youtube_download_status. Это LOW risk tool с AUTO approval: он не меняет состояние файла и не останавливает процесс, а возвращает состояние конкретной job. В интерфейсе полезно различать queued, running, completed, failed и canceled, потому что каждое состояние требует другого действия пользователя.

Если job running, пользователь может продолжить наблюдать или запросить отмену. Если completed, нужно проверить delivery result. Если failed, нужна диагностическая причина: сеть, формат, storage, permission, duplicate conflict, plugin error или другой known failure. Если canceled, важно показать, какая job была остановлена и остались ли действия, которые требуют ручной проверки. Один статус «не получилось» недостаточен: он не помогает пользователю понять, повторять ли download, менять format или проверять устройство.

Отмена выполняется через plugin_youtube_download_cancel. Этот tool относится к DEVICE_CONTROL и REQUIRE_APPROVAL, потому что он управляет активной задачей на устройстве. Нельзя отменять не ту job по догадке. Перед cancel approval пользователь должен увидеть jobId, название или краткое описание исходного видео, выбранный формат и текущее состояние. Если есть несколько загрузок, FoneClaw должен явно связать команду отмены с нужным jobId.

Recovery после отмены и сбоя требует аккуратных ожиданий. Текущая validation boundary не позволяет обещать perfect rollback. Отмена может остановить job, но это не универсальная гарантия, что каждый partial artifact на каждом устройстве и в каждом storage state будет удален одинаково. Поэтому после cancel полезно проверить status, затем delivery location, затем повторить download только после выбора точного формата и новой approval.

В FoneClaw 0.1.0 улучшены Agent task flow, permission recovery и failure handling; актуальные release details доступны в публичных данных релизов FoneClaw. Для plugin workflow это означает более понятный переход между состояниями, но не отменяет проверку устройства, сети, формата и результата. Если status показывает failed, правильная реакция — диагностировать причину, а не автоматически запускать другой формат или другой URL без нового выбора пользователя.

Куда доставляется файл и что еще нужно валидировать

Текущий проверенный delivery path для YouTube Downloader plugin — 360p delivery through Android MediaStore. Формулировка важна: речь не о любом качестве, не о любой папке и не о каждом поведении Android storage на всех устройствах. MediaStore — системный механизм Android для регистрации media-файлов; он позволяет доставить результат в медиасистему устройства без необходимости придумывать нестандартный путь хранения в статье.

После completed state пользователь должен проверить не только факт завершения job, но и доступность файла через ожидаемую media surface Android. Если файл не виден сразу, это может быть связано с обновлением media index, storage state, разрешениями, ограничениями устройства или ошибкой доставки. Хороший agent walkthrough не должен скрывать эти варианты. Он должен показать jobId, результат plugin, expected MediaStore delivery и следующий проверочный шаг.

Что остается валидировать шире: поддержку других форматов, поведение на разных версиях Android и устройствах, cancellation recovery, storage edge cases, нестабильные сети, license validation и сценарии, где content rights или platform terms ограничивают использование. Эти области нельзя превращать в утверждение «все работает всегда». Проверенный 360p path — полезная рабочая база, но не универсальная матрица совместимости.

Также важно не смешивать plugin tools с built-in catalog FoneClaw. Живой каталог FoneClaw содержит 118 built-in tools в 11 категориях, но YouTube Downloader находится вне этого built-in count как plugin. Метаданные текущего каталога доступны в публичном каталоге инструментов FoneClaw. В durable prose мы говорим о 100+ built-in tools, а plugin описываем отдельно, с его собственным trust path и tool policies.

Практический вывод: если вам нужен надежный результат, начинайте с validated path, фиксируйте jobId, проверяйте статус, подтверждайте delivery через MediaStore и только потом расширяйте тесты на другие форматы или устройства. Так вы не путаете одну успешную загрузку с полной compatibility guarantee.

Как использовать плагин правомерно и с понятным контролем

YouTube Downloader plugin нужно использовать только для контента, который вы вправе загружать. Перед удобством идут права автора, разрешение владельца контента, локальные правила и условия использования YouTube. FoneClaw не предназначен для обхода ограничений YouTube, protected content или правил платформы. Мы описываем governed workflow, а не способ получить то, что пользователь не имеет права сохранять.

Перед первой реальной загрузкой проверьте пять вещей. Во-первых, источник plugin: proposal, signed package и trusted fingerprint. Во-вторых, metadata: правильный URL, title и available format choices. В-третьих, approval: download требует явного подтверждения, потому что создает внешний эффект. В-четвертых, job control: сохраните jobId, проверьте status и знайте, что cancel тоже требует approval. В-пятых, result verification: после completed state проверьте MediaStore delivery, а не ограничивайтесь текстом «готово».

Для пользователя это выглядит как обычная задача: «скачать видео YouTube на Android». Для FoneClaw это последовательность контролируемых слоев: пользователь делится ссылкой из YouTube или вставляет URL, модель понимает просьбу, plugin info tool проверяет публичные данные, пользователь выбирает exact format, download tool получает approval, foreground job возвращает jobId, status отслеживает процесс, cancel останавливает выбранную job, а MediaStore delivery подтверждает результат. Бесплатная default model FoneClaw или настроенная совместимая модель могут вести этот сценарий, но tool policy и user approval управляют действиями с последствиями.

FoneClaw и YouTube Downloader остаются бесплатными для пользователя, а локальный plugin не отправляет YouTube URL в сервисы FoneClaw. Это не означает бесплатный интернет, бесплатный мобильный трафик или право скачивать любой контент. Если вам нужен более широкий обзор именно загрузочного сценария, а не playback control, ориентируйтесь на эту последовательность: доверенный plugin, read-only inspection, exact format, approval, jobId, status, cancel и result verification. Так плагин загрузки YouTube Android остается понятным инструментом, а не черным ящиком, который обещает больше, чем подтверждено текущей валидацией.