Первый запуск агента
Цели урока
После прохождения этого урока вы сможете:
- 1Выполнить первоначальную настройку через picoclaw onboard
- 2Отправить первый запрос через picoclaw agent
- 3Переключиться между разными LLM-моделями
- 4Запустить chat gateway для мессенджеров
Onboarding: первоначальная настройка
PicoClaw предоставляет интерактивную команду onboard для первоначальной настройки. Она создаёт директорию конфигурации, генерирует config.json с дефолтными значениями и проводит через основные шаги: выбор LLM-провайдера, ввод API-ключа и проверку подключения.
# Запустить интерактивную настройку
picoclaw onboard
# Процесс onboard:
# 1. Создаёт ~/.picoclaw/
# 2. Создаёт ~/.picoclaw/config.json
# 3. Создаёт ~/.picoclaw/workspace/
# 4. Предлагает выбрать LLM-провайдера
# 5. Запрашивает API-ключ
# 6. Отправляет тестовый запрос для проверкиПервый запрос через CLI
После onboard можно сразу отправить запрос агенту из командной строки. Команда picoclaw agent -m отправляет одноразовый запрос и выводит ответ в терминал.
# Простой запрос
picoclaw agent -m "What is 2+2?"
# Запрос на русском
picoclaw agent -m "Объясни, что такое RISC-V в трёх предложениях"
# Запрос с указанием конкретной модели
picoclaw agent -m "Напиши haiku про Go" --model claude
# Запрос с изменённой температурой
picoclaw agent -m "Придумай 5 названий для стартапа" --temperature 1.2Переключение между моделями
PicoClaw позволяет переключаться между моделями через флаг --model, используя имена из model_list в конфигурации. Это удобно для тестирования: сравните ответы GPT, Claude и DeepSeek на один и тот же запрос.
# Сравнить ответы разных моделей
picoclaw agent -m "Что лучше: RISC-V или ARM для IoT?" --model gpt4
picoclaw agent -m "Что лучше: RISC-V или ARM для IoT?" --model claude
picoclaw agent -m "Что лучше: RISC-V или ARM для IoT?" --model deepseekЗапуск Chat Gateway
Chat Gateway — это HTTP-сервер, который принимает сообщения от мессенджеров (Telegram, Discord, WhatsApp и других) и маршрутизирует их к AI-агенту. Gateway запускается одной командой и работает как фоновый процесс.
# Запустить gateway на порту по умолчанию (8080)
picoclaw gateway
# Запустить на конкретном порту
picoclaw gateway --port 9090
# Запустить в фоновом режиме
picoclaw gateway &
# Проверить, что gateway работает
curl http://localhost:8080/health
# Ожидаемый ответ: {"status":"ok","version":"1.0.0"}Использование web search
PicoClaw поддерживает веб-поиск через Tavily, Brave Search и DuckDuckGo. Агент автоматически использует поиск, когда ему нужна актуальная информация. Для этого достаточно настроить провайдера поиска в конфигурации.
# Запрос, требующий актуальных данных
picoclaw agent -m "Какие новости в мире AI сегодня?"
# Агент автоматически вызовет web search:
# [tool_use: web_search] query="AI news today February 2026"
# [result] Found 5 relevant articles...
# [response] Сегодня в мире AI...Для быстрого тестирования без настройки мессенджеров используйте CLI-режим: picoclaw agent -m "ваш запрос". Это позволяет проверить работу агента, моделей и web search до подключения каналов общения.
При первом запуске PicoClaw проверяет доступность выбранного LLM-провайдера. Если API-ключ неверный или провайдер недоступен, вы получите ошибку с подробным описанием проблемы. Убедитесь, что у вас есть баланс на аккаунте провайдера.
Вопросы для размышления
- •Какую модель вы выбрали при onboard и почему?
- •В чём преимущество CLI-режима перед мессенджерами для тестирования?
- •Как веб-поиск расширяет возможности AI-агента на edge-устройстве?