Если что-то не так

Если что-то пошло не так, сначала спроси в чате: «почему не отвечает Telegram?», «какой интеллект сейчас работает?». Ассистент видит состояние интеллекта, плагинов и машин, и многое чинится кнопкой на карточке, которую он покажет. Если не открывается сам чат, начни с журналов.

Приложение для компьютера#

«Порт … занят»#

Нужный Piomio порт держит другая программа (41780 или соседние 41781 и 41789). Закрой её и нажми Попробовать ещё раз. Или дай Piomio другие порты: впиши {"port": 19000} в desktop.json в его папке данных (где она) и выбери Перезапустить в меню значка.

«Piomio снова и снова останавливается» или «Piomio не ответил вовремя»#

Показать журнал — в окне или в меню значка — открывает журнал хаба с причиной. Попробовать ещё раз запускает его снова. «Файлы Piomio повреждены» значит, что сломано само приложение: установи его заново. Данные лежат в папке пользователя, а не в приложении, поэтому останутся.

«Ссылка для входа устарела. Войдите с паролем.»#

Приложение входит в своё окно по одноразовой ссылке. Если ссылка устарела, один раз войди своим паролем Piomio.

Windows предупреждает, что защитила компьютер#

Приложение для Windows пока не подписано. Выбери «Подробнее» → «Выполнить в любом случае». Смотри Установка на Mac или ПК.

Интеллект и вход#

Ассистент просит подключить интеллект#

Карточка «Чтобы я мог отвечать, подключите интеллект» значит, что ни один интеллект ещё не работает. Нажми Войти у Claude Code, Codex или Kimi Code и войди на странице самого производителя со своим тарифом. На твоё сообщение ответят, как только один заработает. В приложении для компьютера и на сервере недостающий CLI сначала поставится сам. Смотри страницу про интеллект и вход.

Вход в CLI выполнен, но Piomio его не видит#

• Приложение для компьютера: Piomio берёт CLI твоего пользователя и PATH твоей оболочки входа. Только что поставил? Нажми Проверить снова на карточке.
• Сервер: входи от пользователя, под которым работает Piomio, то есть piomio, а не root. Проверь: sudo -iu piomio, потом codex login status или claude auth status. Пока ни один интеллект не работает, Piomio ищет заново каждые 30 секунд.
• Компьютер твоего хаба: входи от пользователя, под которым работает его демон. piomio-node status покажет каждый CLI и выполнен ли в нём вход.

«Вставьте код со страницы входа целиком»#

Claude Code после входа на своей странице показывает код. Скопируй его целиком в карточку, а не в чат. У Codex и Kimi Code наоборот: код с карточки вводишь у них на странице.

«Вход занял слишком много времени и был остановлен»#

Код с карточки действует ограниченное время (карточка пишет, до какого). Нажми Попробовать снова и закончи на странице входа быстрее.

«Kimi Code: тариф этого аккаунта Kimi не включает Kimi Code»#

В аккаунте Kimi, которым ты вошёл, нет тарифа Kimi Code. Войди аккаунтом, где он есть, или возьми другой интеллект.

Интеллект упёрся в лимит#

Агент переходит к следующему интеллекту в своём списке, если он есть. На странице Интеллект видно, до какого времени действует лимит. Дай агентам второй интеллект про запас, смотри страницу про агентов и команду.

Я вставил токен из claude setup-token#

Piomio убирает его из сообщения и нигде не хранит: условия Anthropic не разрешают приложениям хранить такие токены. Войди в Claude Code кнопкой Войти.

Вход в Piomio#

«Неверный код установки» или код потерялся#

Код установки работает только до того, как ты придумаешь пароль. Где его взять:

• Приложение для компьютера: окно открывается с уже вписанным кодом.
• Сервер: sudo -iu piomio cat ~/.local/share/piomio/setup-code

Забыл пароль#

• Сервер: piomio reset-password '<новый пароль>' после sudo -iu piomio.
• Из исходников: node packages/core/src/cli.ts reset-password '<новый пароль>'.

Обе команды завершают все сессии. Приложение для компьютера само входит в своё окно, так что там пароль нужен только в других браузерах.

«Слишком много неудачных попыток. Подождите 15 минут.»#

Десять неверных паролей или кодов с одного адреса за 15 минут на время закрывают этому адресу вход. Подожди или войди на самом компьютере.

«Host not allowed. Add it to PIOMIO_ALLOWED_HOSTS.»#

Ты открыл хаб по адресу, которого он не знает, например по IP сервера или по домену. Впиши этот адрес в PIOMIO_PUBLIC_URL или добавь имя в PIOMIO_ALLOWED_HOSTS и перезапусти. Прежде чем открывать хаб по голому IP, прочитай Почему не по IP сервера?.

Страница открывается, но ничего не сохраняется («Origin not allowed»)#

Адрес в браузере отличается от PIOMIO_PUBLIC_URL хаба, например при SSH-туннеле на другой локальный порт. Ставь одинаковые номера портов по обе стороны туннеля или впиши в PIOMIO_PUBLIC_URL адрес, которым пользуешься на самом деле.

На сервере#

Установщик останавливается, ничего не поставив#

«Piomio не ответил за две минуты»#

Установщик показывает команду, которая открывает журнал: выполни её и прочитай последние строки. Если порт 8080 занят другой программой, впиши другой в ~/.config/piomio/env (PIOMIO_PORT=9090) и выполни systemctl --user restart piomio от piomio.

«Не удалось оставить Piomio работать после выхода из системы»#

Не получилось включить lingering, и Piomio остановится, когда ты выйдешь. Попроси администратора выполнить sudo loginctl enable-linger <пользователь>.

systemctl --user не может подключиться к шине#

Открывай оболочку пользователя через sudo -iu piomio, а не через su или sudo -u: установщик настроил её так, что systemctl --user и journalctl --user там работают.

Чат не открывается на localhost:8080#

Строка ssh -L должна работать всё время, пока открыт чат. На сервере sudo -iu piomio, потом systemctl --user status piomio и journalctl --user -u piomio -n 50 покажут, работает ли Piomio и что ему мешает. Если порт 8080 занят на твоём компьютере, освободи его: туннель на другой локальный порт откроет страницу, но сохранить ничего не даст.

Обновление откатилось на старую версию#

Если новая версия трижды подряд не запустилась, сервер возвращается на прежнюю, с базой как до обновления, и ассистент говорит об этом в чате. Эту версию больше не предложат, а следующую — да. Причину покажет журнал: journalctl --user -u piomio.

Компьютер твоего хаба не подключается#

• «Не удалось достучаться до хаба»: ссылка-приглашение должна открываться с сервера, проверь там curl -I <ссылка>. Хабу дома нужен включённый доступ из любого места.
• «Приглашение устарело или уже использовано»: каждая ссылка работает один раз и один час. Попроси в чате новую и запусти установщик снова.
• Служба piomio-node остановилась: piomio-node status скажет, привязан ли он ещё. Компьютер, удалённый из Машин, подключается заново только с новым приглашением.

Телефон#

Телефон не подключается дома#

Разреши входящие подключения к порту для телефонов в файрволе компьютера: 8082 на сервере (ufw allow 8082/tcp), 41782 в приложении для компьютера. Или включи доступ из любого места, и телефон пойдёт по ссылке. Смотри Приложение для iPhone.

«Телефоны не видят хаб»#

Порт для телефонов закрыт (PIOMIO_DEVICES=0), а доступ из любого места выключен. Включи одно из двух.

«У компьютера нет сетевого адреса, доступного телефону»#

Подключи компьютер к Wi-Fi или Tailscale.

«Порт … для телефонов занят другой программой»#

Задай в PIOMIO_DEVICE_PORT свободный порт и перезапусти Piomio.

«Приглашение устарело или уже использовано»#

Каждый QR-код и каждая ссылка работают один раз. Скажи в чате «подключи мой телефон» или снова нажми Подключить телефон в Настройки → Устройства.

«Подтверждение Face ID не прошло проверку»#

Подпись подтверждения с телефона не сошлась. Попробуй ещё раз.

Доступ из любого места#

«В этой сборке Piomio нет доступа из любого места»#

Нет узла Tailscale хаба. В приложении для компьютера и в установке на сервер он есть; если запускаешь из исходников, собери его командой npm run build:tailnet (нужен Go).

«Tailscale ждёт, пока администратор вашей сети подтвердит машину piomio»#

В твоей сети Tailscale новые машины нужно подтверждать. Подтверди piomio в консоли администратора Tailscale, в разделе Machines.

Ключи доступа не работают по ссылке#

Ключи доступа (passkeys) привязаны к собственному адресу компьютера. По ссылке входи паролем.

«Вход извне приостановлен на час»#

За час через ссылку пришло 30 неверных паролей, и вход извне остановлен на час. На самом компьютере войти по-прежнему можно. Если это был не ты, смени пароль в пульте безопасности.

Пульт безопасности не открывается по ссылке#

Так задумано: пульт, первая настройка и вебхуки плагинов никогда не ходят через ссылку. Открывай пульт на самом компьютере или через SSH-туннель на порт 8081. Смотри Доступ из любого места.

Telegram#

«Telegram не принял токен бота»#

Получи новый токен у @BotFather и скажи в чате «подключи Telegram»: карточка примет новый. Смотри Telegram.

Бот не отвечает#

Он ждёт привязки. На карточке Telegram нажми Открыть бота в Telegram и нажми там Start, или отправь боту команду /start с кодом с карточки. Бот отвечает только одному личному чату — тому, к которому привязан.

«Извините, этот бот личный и уже привязан к другому чату.»#

Нажми Отвязать на карточке Telegram, потом привяжи бота заново из нужного чата.

«… больше 20 МБ»#

Telegram не отдаёт ботам файлы крупнее. Отправь такой файл в веб-чате.

«Бот заблокирован в привязанном чате»#

Ты заблокировал бота в Telegram. Разблокируй его там.

Хранилище#

Хранилище заперто#

После перезапуска хранилище запечатано, пока ты его не откроешь, и всё это время агенты не могут пользоваться ключами и входить на сайты. Открой его на карточке в чате или в пульте безопасности. Оставь включённым Открывать автоматически после перезапуска (пароль хранится на этом сервере) — и в следующий раз оно откроется само. Ещё можно дать ему файл с паролем через PIOMIO_VAULT_PASSPHRASE_FILE, смотри Запечатано после перезапуска.

«Автоматическая разблокировка из файла настроена, но не сработала»#

В журнале будет [vault] auto-unlock failed с причиной: обычно в файле неверный пароль или хаб не может прочитать файл.

Я забыл пароль хранилища#

Его не восстановить: ни Piomio, ни кто-либо ещё не расшифрует хранилище без него. В этом и смысл хранилища.

Браузер и сеть#

«Устанавливается Chromium»#

Браузер агентов один раз скачивает Chromium при первом использовании, а браузерные действия ждут. Подожди минуту.

«Не удалось установить Chromium»#

Попытка повторится, когда браузер понадобится в следующий раз. На сервере проверь, что у него есть доступ в интернет.

«Chromium не установлен, а автоматическая установка выключена»#

Задана PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD. Убери её или поставь Chromium сам: npx playwright install chromium.

Браузер не запускается на сервере#

Chromium нужны системные библиотеки, а установщик ставит их только при первой установке под root в системах с apt-get. Поставь их под root:

/home/piomio/.local/lib/piomio/current/runtime/bin/node /home/piomio/.local/lib/piomio/current/node_modules/playwright/cli.js install-deps chromium

«… resolves to a private address; add it to egressPrivateAllow to allow»#

Плагин или интеллект попытался выйти к хосту в твоей локальной сети, а фильтр исходящих соединений такое не пускает. Если хост твой, добавь его в egressPrivateAllow, смотри Настройки без поля.

Где журналы#

Резервные копии и начало с нуля#

Сделать резервную копию#

• Сервер: piomio backup пишет копию в ~/.local/share/piomio/backups. Смотри Резервные копии.
• Приложение для компьютера: выйди из Piomio (Выйти из Piomio в меню значка) и скопируй его папку данных.

Восстановить из копии#

Команды восстановления нет. Останови Piomio, отложи в сторону piomio.db и vault.db из папки данных вместе с их файлами -wal и -shm, скопируй на их место файлы и папки из копии и запусти Piomio снова. Хранилище откроется тем паролем, который был у него в момент копии.

Начать с нуля#

• Приложение для компьютера: Сбросить Piomio… в меню значка или в Настройки → Общие → Это приложение. После вопроса оно удалит чаты, агентов, память, хранилище, плагины, настройки и связь этого компьютера с хабом. Входы в Claude Code и Codex останутся: они принадлежат этим программам.
• Сервер: от piomio выполни systemctl --user stop piomio, отложи в сторону ~/.local/share/piomio, потом systemctl --user start piomio. Хаб запустится пустым, с новым кодом установки; входы в CLI останутся.