Установка PicoClaw

Четыре способа установки PicoClaw

PicoClaw предлагает несколько способов установки в зависимости от платформы и предпочтений: сборка из исходников, Docker, prebuilt binaries и установка через Termux на Android. Для большинства разработчиков рекомендуется сборка из исходников — она занимает не более 3 минут.

Способ 1: Сборка из исходников (рекомендуется)

Для сборки из исходников необходим Go 1.22+. Команда Sipeed использует Makefile для автоматизации сборки, включая загрузку зависимостей и кросс-компиляцию.

bash

# Клонировать репозиторий
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Загрузить зависимости Go
make deps

# Собрать бинарник для текущей платформы
make build

# Проверить сборку
./build/picoclaw --version

Способ 2: Docker Compose

Docker — удобный способ запуска PicoClaw на серверах и десктопах. Docker Compose конфигурация включает профиль gateway для запуска chat-сервера.

bash

# Клонировать репозиторий
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Запустить через Docker Compose с chat gateway
docker compose -f docker/docker-compose.yml --profile gateway up -d

# Проверить статус
docker compose -f docker/docker-compose.yml ps

# Посмотреть логи
docker compose -f docker/docker-compose.yml logs -f

Способ 3: Prebuilt binaries

На странице Releases в GitHub доступны готовые бинарники для основных платформ. Этот способ не требует установки Go и подходит для быстрого тестирования.

bash

# Скачать бинарник для Linux ARM64 (например, для Raspberry Pi)
curl -L https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64 -o picoclaw

# Сделать исполняемым
chmod +x picoclaw

# Переместить в PATH
sudo mv picoclaw /usr/local/bin/

# Проверить
picoclaw --version

Способ 4: Android через Termux

PicoClaw можно запустить на старом Android-телефоне через Termux — эмулятор терминала для Android. Это превращает неиспользуемый смартфон в полноценного AI-агента.

bash

# Установить Termux из F-Droid (не из Google Play!)
# Внутри Termux:

# Обновить пакеты
pkg update && pkg upgrade

# Установить Go
pkg install golang

# Клонировать и собрать PicoClaw
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
go build -o picoclaw ./cmd/picoclaw/

# Запустить
./picoclaw --version

Кросс-компиляция для RISC-V

Если вы планируете запускать PicoClaw на RISC-V плате (LicheeRV-Nano), можно скомпилировать бинарник на обычном компьютере и затем скопировать его на плату.

bash

# Кросс-компиляция для RISC-V
GOOS=linux GOARCH=riscv64 make build

# Скопировать бинарник на плату по SSH
scp build/picoclaw root@192.168.1.100:/usr/local/bin/

# Подключиться к плате и проверить
ssh root@192.168.1.100
picoclaw --version

Версия Termux из Google Play устарела и не поддерживается. Всегда устанавливайте Termux из F-Droid (f-droid.org) для получения актуальной версии с последними обновлениями безопасности.

Для IoT-сценариев рекомендуется кросс-компиляция на мощной машине с последующим копированием бинарника на целевое устройство. Сборка Go на RISC-V плате с 64 МБ RAM может занять до 10 минут.

Четыре способа установки PicoClaw

Способ 1: Сборка из исходников (рекомендуется)

bash

# Клонировать репозиторий
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Загрузить зависимости Go
make deps

# Собрать бинарник для текущей платформы
make build

# Проверить сборку
./build/picoclaw --version

Способ 2: Docker Compose

bash

# Клонировать репозиторий
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Запустить через Docker Compose с chat gateway
docker compose -f docker/docker-compose.yml --profile gateway up -d

# Проверить статус
docker compose -f docker/docker-compose.yml ps

# Посмотреть логи
docker compose -f docker/docker-compose.yml logs -f

Способ 3: Prebuilt binaries

bash

# Скачать бинарник для Linux ARM64 (например, для Raspberry Pi)
curl -L https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64 -o picoclaw

# Сделать исполняемым
chmod +x picoclaw

# Переместить в PATH
sudo mv picoclaw /usr/local/bin/

# Проверить
picoclaw --version

Способ 4: Android через Termux

bash

# Установить Termux из F-Droid (не из Google Play!)
# Внутри Termux:

# Обновить пакеты
pkg update && pkg upgrade

# Установить Go
pkg install golang

# Клонировать и собрать PicoClaw
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
go build -o picoclaw ./cmd/picoclaw/

# Запустить
./picoclaw --version

Кросс-компиляция для RISC-V

bash

# Кросс-компиляция для RISC-V
GOOS=linux GOARCH=riscv64 make build

# Скопировать бинарник на плату по SSH
scp build/picoclaw root@192.168.1.100:/usr/local/bin/

# Подключиться к плате и проверить
ssh root@192.168.1.100
picoclaw --version

Цели урока

Четыре способа установки PicoClaw

Способ 1: Сборка из исходников (рекомендуется)

Способ 2: Docker Compose

Способ 3: Prebuilt binaries

Способ 4: Android через Termux

Кросс-компиляция для RISC-V

Вопросы для размышления

Установка PicoClaw

Цели урока

Четыре способа установки PicoClaw

Способ 1: Сборка из исходников (рекомендуется)

Способ 2: Docker Compose

Способ 3: Prebuilt binaries

Способ 4: Android через Termux

Кросс-компиляция для RISC-V

Вопросы для размышления