Teleportus

Русский

English

Русский

English

Решение проблем ​

Чёрный экран в Mini App ​

Причина: разрешение «Запись экрана» отсутствует или было отозвано.

Решение:

  1. Откройте Системные настройки → Конфиденциальность и безопасность → Запись экрана
  2. Найдите node (или Bun) в списке и включите переключатель
  3. Остановите демон и запустите снова — изменения разрешений вступают в силу после рестарта

Swift-бинарник

Бинарник для захвата экрана — скомпилированный Swift-инструмент. На некоторых версиях macOS нужно добавить его явно. Ищите screenshot-bin в списке «Запись экрана», если node сам по себе не помогает.

Ввод игнорируется (тапы не работают) ​

Причина: разрешение «Универсальный доступ» отсутствует или было отозвано.

Решение:

  1. Откройте Системные настройки → Конфиденциальность и безопасность → Универсальный доступ
  2. Включите переключатель для node (или Bun)
  3. Перезапустите демон

«SESSION_TOKEN required» ​

Демон завершается сразу при старте. Убедитесь что токен задан:

bash
npx remote-claude-daemon@latest --token {{SESSION_TOKEN}}

Mini App показывает «ожидание демона…» ​

Релей доступен, но демон не зарегистрировался. Запустите демон на Mac. Mini App опрашивает каждые несколько секунд и подключится автоматически.

Стрим замерзает или тормозит ​

Проверьте частоту кадров — по умолчанию 6 fps. Повысьте через FPS=15 если сеть позволяет.

Проверьте подключение — демон логирует переподключение при разрыве WebSocket. Жёлтая точка в Mini App означает что идёт переподключение.

Медленная сеть — трафик зависит от разрешения экрана, того, насколько сильно меняется картинка, и частоты кадров. Статичный экран почти ничего не стоит (демон пропускает неизменившиеся кадры), а непрерывное полноэкранное движение при 6 fps может занимать несколько Мбит/с. Если стрим не успевает — снизьте частоту кадров или смотрите на более быстром соединении. Убедитесь что у Mac есть исходящее подключение до релея.

Бинарник для скриншота не компилируется ​

Запустите с --debug чтобы увидеть полный вывод swiftc:

bash
npx remote-claude-daemon@latest --token {{SESSION_TOKEN}} --debug

Частые причины:

  • Не установлены Xcode Command Line Tools — выполните xcode-select --install
  • Слишком старая версия macOS — требуется macOS 12+

Аудио тихое или с задержками ​

  • Проверьте что выход Mac не заглушён
  • Swift-бинарник для аудио требует разрешение на микрофон для входящего направления — выдайте его в Системных настройках → Конфиденциальность и безопасность → Микрофон
  • Перезапустите демон после выдачи разрешения

AI-задачи не отвечают ​

  • Убедитесь что демон запущен и подключён (зелёная точка в Mini App)
  • AI-раннер использует Claude; проверьте что переменная ANTHROPIC_API_KEY задана если вы запускаете свой релей
  • Длинные задачи таймаутятся через 5 минут — разбейте на более мелкие шаги

Демон крашится сразу на Apple Silicon ​

Если вы видите SIGILL или сообщение «killed», скомпилированные Swift-бинарники могут не соответствовать архитектуре. Удалите их и дайте демону перекомпилировать:

bash
cd $(npm root -g)/remote-claude-daemon
rm -f screenshot-bin macos-universal-*
npx remote-claude-daemon@latest   # перекомпилирует при старте

Всё ещё не работает? ​

Откройте Telegram и опишите проблему боту — включите сообщение об ошибке из логов демона. Также можно создать issue на GitHub.