Как подключить API модели ИИ на Android в FoneClaw
Настройка провайдера, базового URL, API-ключа и идентификатора модели в FoneClaw. Отдельные проверки текста, изображений и инструментов Android, диагностика ошибок.
- В FoneClaw можно использовать бесплатную модель по умолчанию или настроить совместимого онлайн-провайдера. Подписка на приложение чат-бота и доступ к его API имеют отдельные условия.
- Предустановка провайдера упрощает настройку, но базовый URL, API-ключ и точный идентификатор модели нужно сверить с выбранным сервисом. Параметры поддержки изображений и инструментов должны соответствовать реальным возможностям модели.
- Проверяйте последовательно текстовый ответ, интерпретацию выбранного изображения и вызов одного инструмента чтения состояния Android. Успех первого теста не подтверждает работу двух остальных.
- Недоступная или снятая с обслуживания модель — проблема API, а не доказательство сбоя разрешений телефона. После смены модели повторите проверки и выясните результат предыдущего действия до повторной отправки или записи.
Выберите модель по умолчанию или свой API
Чтобы подключить API модели ИИ на Android в FoneClaw, выберите совместимого провайдера, укажите базовый URL API, ключ и точный идентификатор модели, затем отдельно проверьте текст, изображения и инструменты телефона. Если собственного API пока нет, начните с бесплатной модели по умолчанию: она уже доступна внутри FoneClaw.
В обоих случаях выбранная модель понимает запрос и строит план внутри FoneClaw, а включенные инструменты выполняют поддерживаемые Android-действия с учетом разрешений, состояния приложения и действующей политики подтверждения. Вы настраиваете модель для агента, а не передаете управление телефону отдельному приложению чат-бота.
| Путь | Когда выбирать | Что проверить |
|---|---|---|
| Модель по умолчанию | Нужен старт без собственного API-ключа | Поддерживаемую задачу, доступные инструменты и результат |
| Совместимый онлайн-провайдер | Нужна конкретная модель или условия обработки и оплаты | Совместимость API, доступ аккаунта и возможности модели |
| Замена настроенной модели | Изменились требования задачи или доступность модели | Новый идентификатор, формат запросов и три отдельных теста |
Подписка на пользовательское приложение чат-бота не означает, что у вас есть API-ключ, оплаченные API-запросы или доступ к нужной модели. Эти условия проверяются в аккаунте провайдера отдельно. Общий путь от запроса к действию разобран в материале Управление Android ИИ-агентом: намерение, подтверждение и проверка результата.
Предустановка провайдера, базовый URL, ключ и идентификатор модели
В FoneClaw доступны предустановки онлайн-провайдеров и параметры поддержки изображений и вызова инструментов. Предустановка помогает заполнить конфигурацию, но не подтверждает доступ вашего аккаунта и не делает любой API совместимым. Проверяйте значения по документации именно того сервиса, куда будут отправляться запросы.
| Поле или параметр | Назначение | Что сверить |
|---|---|---|
| Предустановка провайдера | Упрощает выбор конфигурации сервиса | Соответствует ли вашему провайдеру и способу подключения |
| Базовый URL API | Задает адрес совместимой конечной точки | Протокол, путь и версию API |
| API-ключ | Подтверждает доступ к сервису | Действительность, права и аккаунт владельца |
| Идентификатор модели | Выбирает модель на этой конечной точке | Точное написание и доступность вашему аккаунту |
| Поддержка изображений | Настраивает передачу изображений модели | Поддерживает ли модель визуальный ввод в выбранном API |
| Поддержка инструментов | Настраивает использование вызовов инструментов | Поддерживают ли модель и API нужный формат вызова |
Базовый URL берите из документации провайдера. Не все сервисы используют одинаковые пути и форматы запросов. Например, документация Gemini API о совместимости с OpenAI описывает конкретный совместимый способ подключения, а не универсальный адрес для всех моделей.
API-ключ — секрет. Не публикуйте его, не показывайте на скриншотах и не отправляйте в переписку поддержки. Документация OpenAI по аутентификации API объясняет назначение ключа; права и ограничения других провайдеров нужно сверять у них отдельно.
Идентификатор модели копируйте из панели сервиса или документации, а не угадывайте по рекламному названию. Частые ошибки — лишний путь в базовом URL, пробелы вокруг ключа и человекочитаемое название вместо точного идентификатора. Правильные значения этих полей разрешают запросы к модели, но сами по себе не дают доступа к ресурсам Android.
Настройте провайдера и возможности модели
Перед настройкой подготовьте адрес API, ключ и доступный идентификатор модели. Для рабочего аккаунта используйте ключ с нужными правами, понятным владельцем и возможностью отзыва. Уточните, как оплачиваются запросы и какой контекст получает провайдер.
- Откройте настройки модели в FoneClaw.
- Оставьте модель по умолчанию, если хотите начать без собственного API.
- Для своего провайдера выберите подходящую предустановку, если она доступна.
- Сверьте базовый URL с документацией совместимого API.
- Введите ключ без лишних пробелов и точный идентификатор доступной модели.
- Настройте поддержку изображений и инструментов согласно возможностям модели и конечной точки.
- Сохраните конфигурацию и выберите настроенную модель для работы в FoneClaw.
- Проверьте текстовый ответ, затем изображение и один инструмент Android.
Переключатель поддержки изображений не добавляет зрение текстовой модели. Аналогично параметр вызова инструментов не исправляет API, который не поддерживает нужный формат. Для интерпретации фото требуется совместимая модель с визуальными возможностями. FoneClaw оптимизирует выбранные большие изображения и корректирует их ориентацию, но это подготовка входных данных, а не замена возможностей модели.
Если вы сравниваете несколько моделей, заранее решите, что важно: время ответа, стоимость запросов, стабильность формата или работа с изображениями и инструментами. Более подробный выбор разобран в статье Kimi K3, DeepSeek V4 и GLM-5.2 для агентов телефона: как выбрать модель без гонки лидеров.
Проверьте текст, изображение и инструмент Android отдельно
После сохранения конфигурации начните с короткого вопроса без личных данных: например, попросите переформулировать нейтральную фразу. Полученный ответ проверяет базовый путь запроса: адрес API, аутентификацию, идентификатор модели и обработку ответа. Он еще не подтверждает поддержку изображений или вызова инструментов.
Второй тест — выбранное вами изображение без чувствительных данных. Если модель поддерживает визуальный ввод, приложите простое фото предмета и попросите описать видимые детали. Сравните ответ с изображением. Отказ API принять картинку и неверное описание принятого изображения требуют разных проверок: в первом случае смотрите формат и поддержку ввода, во втором — содержание ответа и выбранную модель.
Третий тест — один включенный инструмент чтения состояния телефона. Например, попросите FoneClaw проверить текущую медиагромкость без ее изменения. Успехом считается выполнение поддерживаемого инструмента и показ фактического значения, которое можно сверить на телефоне. Фраза модели «я проверил» без результата выполнения не заменяет такую проверку.
Модель формирует запрос к инструменту, а FoneClaw выполняет доступный шаг в рамках разрешений и действующей политики подтверждения. Если нужный доступ отсутствует или инструмент выключен, исправляйте именно этот уровень. Не выдавайте дополнительные разрешения ради теста текстового ответа или изображения: они не исправят несовместимый API.
Найдите причину ошибки перед повтором
Ошибки подключения относятся к разным уровням. У API могут быть неверный ключ, адрес, недоступная модель, тайм-аут или неподдерживаемый формат. На Android могут мешать выключенный инструмент, отсутствующее разрешение, ожидание подтверждения или изменившееся состояние приложения. Проверяйте сообщение об ошибке прежде, чем менять сразу несколько настроек.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| 401, ошибка аутентификации | Ключ отсутствует, недействителен, отозван или имеет неподходящие права | Ключ, аккаунт и правила доступа провайдера |
| 404, ресурс не найден | Неверный адрес, путь API или идентификатор модели | Базовый URL и доступную модель для выбранной конечной точки |
| Тайм-аут | Проблема сети, задержка сервиса или слишком большой запрос | Соединение и короткий текстовый запрос без лишнего контекста |
| Модель недоступна | Нет доступа у аккаунта либо обслуживание модели прекращено | Доступность в панели провайдера и официальный жизненный цикл |
| Текст работает, изображение не принимается | Модель или API не поддерживает визуальный ввод либо неверна настройка | Возможности модели, формат запроса и параметр поддержки изображений |
| Текст работает, вызов инструмента отклоняется | Несовместимый формат или неподдерживаемый вызов инструментов | Документацию API и параметр поддержки инструментов |
| Инструмент выбран, действие не выполняется | Инструмент выключен, ожидается подтверждение или изменилось состояние приложения | Статус выполнения, настройки инструмента и текущий экран |
| Отказ в разрешении Android | Нужный системный доступ не выдан или отозван | Разрешение конкретного ресурса для этой задачи |
Коды 401 и 404 дают направление проверки, но провайдер может использовать их со своими пояснениями. Пометка об устаревании модели тоже не равна прекращению ее работы: различайте предупреждение о будущей замене и уже завершенное обслуживание.
Если конфигурация работала и сервис временно перестал отвечать, порядок продолжения описан в материале Сбой модели ИИ-ассистента на Android: как безопасно повторить запрос и продолжить задачу. Для примеров разных провайдеров сохранены отдельные разборы: DeepSeek и управление Android: где нужен агент телефона и Может ли Grok управлять телефоном Android: звонки, помощник и настройка в FoneClaw.
Проверьте жизненный цикл модели перед заменой
Помимо качества ответов и стоимости, у настроенной модели нужно проверять срок обслуживания. Конкретный пример из официальной таблицы жизненного цикла моделей Anthropic: модель claude-sonnet-4-5-20250929 получила статус устаревшей 30 сентября 2026 года, а прекращение ее обслуживания запланировано на 30 ноября 2026 года. Рекомендованная замена — claude-sonnet-5-5. Статус устаревшей модели означает, что она пока остается работоспособной; после прекращения обслуживания запросы к ней завершаются ошибкой.
Эти даты относятся к платформам, которыми управляет Anthropic. Партнерские сервисы устанавливают собственные сроки. Поэтому проверяйте доступный идентификатор модели именно у своего провайдера, даже если название семейства совпадает.
Рекомендация заменить Sonnet не подтверждает совместимость нативного Anthropic Messages API с настроенным в FoneClaw подключением в формате OpenAI. Перед заменой сверяйте протокол, конечную точку и доступ аккаунта. Одной подстановки названия модели может быть недостаточно.
Полезные критерии выбора остаются прежними: совместимость, время ответа, стабильность формата, стоимость, обработка контекста и поведение при ошибках. Скорость модели не равна скорости всего действия: она не устраняет ожидание системного разрешения или загрузки приложения. После миграции повторите три теста — текст, изображение при наличии поддержки и один инструмент чтения состояния.
Повторите проверку и продолжите незавершенное действие
В FoneClaw пользователь задает цель, выбранная модель интерпретирует запрос и строит план, а включенные инструменты выполняют поддерживаемые шаги. Разрешения Android, состояние приложения и фактическая политика подтверждения остаются отдельными условиями. Настройка нового API не меняет их автоматически.
После замены модели сначала проверьте чтение медиагромкости или другое доступное действие без изменения данных. Затем возвращайтесь к своей задаче. Если предыдущая попытка включала отправку сообщения, создание события или другую запись, сначала осмотрите целевое приложение: действие могло завершиться до ошибки ответа модели. Повторяйте только незавершенную часть, чтобы не создать дубликат.
Порядок проверки состояния и восстановления разобран в руководстве Диагностика и восстановление телефонного ИИ-агента: как найти причину сбоя и безопасно повторить шаг. Поддерживаемые возможности настройки и Android-инструментов перечислены на странице функций FoneClaw, а варианты получения приложения — на странице загрузки FoneClaw.
Онлайн-модель может получать переданный вами текст и выбранные изображения. Исполнение инструмента на телефоне не означает, что все рассуждение происходит локально. Проверяйте условия провайдера и передавайте только нужный для задачи контекст.