- Дата публикации
PiClaw: локальный AI‑агент на Raspberry Pi с веб‑интерфейсом и редактором кода
Что появилось / что изменилось
PiClaw — это готовая песочница для запуска Pi Coding Agent в Docker-контейнере с Debian. Разработчик собрал вокруг Pi SDK полноценное веб‑приложение и рабочее окружение, а не просто CLI‑бота.
Главные новшества:
- Стриминговый веб‑интерфейс: ответы приходят токен-за-токеном по SSE. Поддерживаются Markdown, KaTeX и диаграммы Mermaid прямо в браузере.
- Постоянные сессии: все сообщения, медиа, задачи, статистика по токенам и ключи лежат в SQLite. История не пропадает между перезапусками контейнера.
- Рабочее пространство /workspace: файловый менеджер в сайдбаре с предпросмотром, «пилюлями» ссылок на файлы для промпта и загрузкой файлов drag‑and‑drop.
- Визуализация диска: «звезда» по размерам папок с наведением и проваливанием внутрь.
- Встроенный редактор кода на базе CodeMirror 6: подсветка синтаксиса для 12 языков (JS/TS с JSX/TSX, Python, Go, JSON, CSS, HTML, YAML, SQL, XML/SVG, Markdown, Shell), поиск/замена и сохранение.
- Ограничение на размер файла в редакторе: редактировать можно текстовые файлы до 256 КБ.
- Аутентификация: поддержка passkeys (WebAuthn) с fallback на TOTP или наоборот. Режимы:
totp-fallback,passkey-only,totp-only. - Опциональный WhatsApp‑канал: второй канал общения с агентом, помимо веб‑интерфейса.
- Планировщик задач: можно запускать задания по расписанию.
- Набор «скиллов»: настройка окружения, отладка, Playwright, веб‑поиск, построение графиков и другие сценарии.
Все это упаковано в Docker‑образ с простым запуском через make build и make up.
Как это работает
В основе PiClaw — Docker‑контейнер с Debian, внутри которого крутится Pi Coding Agent и оркестратор piclaw. Запуск происходит через supervisord: он поднимает все необходимые процессы при старте контейнера.
Веб‑интерфейс слушает порт 8080 по умолчанию (перенастраивается через переменную окружения PICLAW_WEB_PORT). Общение с браузером идет по SSE: сервер отправляет поток токенов, а фронтенд рендерит Markdown, формулы KaTeX и схемы Mermaid на лету.
Файловое дерево строится поверх каталога /workspace. Там же лежит состояние piclaw и заметки. Отдельный SQLite‑файл /workspace/.piclaw/store/messages.db хранит всю историю чатов, медиа и задачи. Его автор прямо просит не трогать — потеряете весь контекст.
Редактор кода встроен в сам интерфейс: при клике на иконку карандаша для текстового файла до 256 КБ открывается центральная панель. CodeMirror 6 дает подсветку, поиск (Cmd/Ctrl+F), замену (Cmd/Ctrl+H), сохранение (Cmd/Ctrl+S) и отслеживание «грязного» состояния. Включены перенос строк, номера строк и подсветка активной строки. Бандл фронтенда — около 245 КБ в gzip, без внешних CDN.
Аутентификация строится на WebAuthn passkeys и TOTP. Секрет для TOTP задается через PICLAW_WEB_TOTP_SECRET (Base32). Режим работы выбирается переменной PICLAW_WEB_PASSKEY_MODE. Это позволяет использовать PiClaw как веб‑приложение на iOS и Android.
Для работы за реверс‑прокси (Cloudflare Tunnel, Caddy, Nginx) есть флаг доверия к прокси: PICLAW_TRUST_PROXY=1 или настройка в .piclaw/config.json. В этом случае PiClaw корректно понимает внешние хосты и схемы по заголовкам Forwarded или X-Forwarded-*.
Что это значит для вас
PiClaw полезен, если вы хотите локального помощника‑разработчика, который живет в Docker‑контейнере и не разъезжается по разным сервисам. Несколько типичных сценариев:
- Разработка и отладка кода: агент видит файлы в
/workspace, вы можете быстро открывать и править их в редакторе, а затем просить Pi Coding Agent продолжить, переписать или протестировать фрагменты. - Работа с проектами на Raspberry Pi: PiClaw ориентирован на Pi‑устройства, но его можно крутить и на обычном сервере с Docker. Это удобный способ дать себе «умный» интерфейс к файловой системе проекта.
- Анализ структуры проекта: визуализация дискового использования помогает понять, какие директории разрослись, и навести порядок в репозитории.
- Автоматизация по расписанию: за счет встроенного планировщика можно поручить агенту регулярные задачи — от генерации отчетов до проверки состояния проекта.
- Мобильный доступ: интерфейс спроектирован mobile‑first, с манифестом веб‑приложения. Можно «установить» PiClaw как иконку на смартфон и получать стриминговые ответы.
Где PiClaw не поможет:
- Если вы не готовы возиться с Docker и конфигами, проще взять готовый облачный сервис с чат‑интерфейсом.
- Если вам нужен только чат без доступа к файловой системе и коду, все возможности воркспейса будут лишними.
- Если вы не можете или не хотите поднимать локальный сервис (например, из‑за ограничений в корпоративной сети), развертывание PiClaw будет сложным.
Если вы находитесь в России, PiClaw как локальный Docker‑контейнер не зависит от геоблокировок сам по себе. Но доступ к внешним API через Pi Coding Agent может потребовать VPN или прокси — это уже зависит от выбранных провайдеров и их политики.
Место на рынке
PiClaw стоит рядом с такими проектами, как agentbox и nanoclaw, от которых он и вдохновился. Все три решают схожую задачу: дать разработчику локальный агент с доступом к файлам и задачам. Отличие PiClaw — ставка на Pi SDK и аккуратная упаковка в Docker с упором на Raspberry Pi и веб‑интерфейс.
По сравнению с чистым CLI‑подходом PiClaw предлагает куда более комфортную работу с кодом: файловый менеджер, редактор, визуализацию диска и стриминг ответов. Это делает его ближе к локальной IDE с AI‑ассистентом, чем к обычному чат‑боту.
Прямых числовых сравнений по скорости с GPT‑4o, Claude 4 или другими моделями автор не приводит. Фокус проекта — не на бенчмарках, а на оркестрации Pi Coding Agent и интеграции с рабочим окружением разработчика. Если вам важны именно латентность и цена токена, эти параметры придется проверять отдельно на вашем железе и выбранном бэкенде.