Первый запуск

После установки до первого полезного результата — три шага: запустить приложение, пройти мастер настройки и написать сообщение агенту.

Запуск

taigaclaw

Что произойдёт:

  1. Создастся каталог данных (пути — в установке); при наличии старого ~/.taigaclaw данные мигрируют автоматически
  2. Поднимется HTTP-сервер на 127.0.0.1:14888
  3. Откроется браузер со страницей первичной настройки

Если браузер не открылся — зайдите на http://127.0.0.1:14888 вручную; ссылка с setup-токеном печатается в терминале при старте.

Мастер настройки

При первом запуске WebUI предложит:

  1. Создать администратора — логин и пароль (Argon2id, JWT-сессии)
  2. Первый агент — создаётся автоматически («Default Agent»), потом можно добавить своих
  3. LLM-провайдер — подключите хотя бы один, иначе агент не сможет отвечать (следующий раздел)

Подключение LLM-провайдера

Settings → Провайдеры → Добавить, затем нажмите «Тест» для проверки и отметьте «По умолчанию».

OpenAI / DeepSeek / Qwen / Gemini (OpenAI-совместимые)

  • Тип: OpenAI-compatible
  • API Base: URL провайдера (например, https://api.deepseek.com/v1)
  • API Key: ваш ключ
  • Модель: например, deepseek-chat

Anthropic (Claude)

  • Тип: Anthropic
  • API Key: ваш ключ
  • Модель: например, claude-sonnet-4-20250514

Ollama (локальные модели, без внешних сервисов)

  • Тип: Ollama
  • API Base: http://localhost:11434/v1
  • Модель: например, llama3 или qwen2.5

API-ключи шифруются (AES-256-GCM) и хранятся в базе — в открытом виде их приложение не принимает.

Первый диалог с агентом

Откройте Чат и напишите сообщение — агент ответит потоково (streaming) и сможет пользоваться инструментами: файлами, командами, веб-поиском. По умолчанию все инструменты закрыты — разрешения выдаются на странице агента /agents/{id}/permissions.

Полезные команды в чате:

КомандаДействие
/stopОстановить текущий ответ
/compactСжать историю сессии (компакция)
/clearОчистить историю чата

Обновление

Приложение проверяет обновления само: WebUI покажет «Доступна новая версия» — обновление одним нажатием, бинарник заменяется атомарно. Подробнее — автообновление.


Проверено на TaigaClaw 1.7.10, октябрь 2026.