Настройка
TaigaClaw настраивается в четыре слоя:
- CLI-флаги и переменные окружения — параметры запуска: адрес, порт, каталог данных
- WebUI Settings — все настройки продукта: провайдеры, агенты, права, база данных
- Расширенные настройки (Advanced) — таймауты, лимиты, RAG, память — применяются без рестарта
- Конфигурация агента — у каждого агента свои модель, инструменты и «душа»
Настройки хранятся в базе (SQLite или PostgreSQL) и применяются на лету (hot-reload) — файлов конфигурации руками править не нужно.
LLM-провайдеры
Подключение — Settings → Провайдеры (пошагово — в первом запуске). Поддерживается 20+ провайдеров; основные категории:
| Категория | Провайдеры | Модель по умолчанию (пример) |
|---|---|---|
| Облачные | OpenAI, Anthropic, DeepSeek, Google Gemini, Mistral, Groq, Qwen, Moonshot/Kimi, GLM, MiniMax, StepFun | gpt-4o, claude-sonnet-4-20250514, deepseek-chat |
| Российские | YandexGPT, GigaChat | yandexgpt-lite |
| Локальные | Ollama, vLLM, LM Studio | llama3 |
| Прокси/агрегаторы | OpenRouter, LiteLLM, Custom (любой OpenAI-совместимый endpoint) | — |
Практика:
- Нажмите «Тест» после ввода ключа — проверка подключения без сохранения
- Отметьте «По умолчанию» провайдера, которого агент будет использовать
- Можно задать цепочку fallback-моделей — при сбое запрос уйдёт на следующую
- Явный флаг «Принимает изображения» включает vision-режим для соответствующих моделей
Параметры запуска
Базовые параметры сервера задаются при старте:
| Флаг | ENV | По умолчанию | Описание |
|---|---|---|---|
--port | TAIGACLAW_PORT | 14888 | Порт HTTP-сервера |
--bind | TAIGACLAW_BIND | 127.0.0.1 | Адрес привязки (0.0.0.0 — доступ извне, только за reverse-proxy с TLS) |
--no-tray | — | — | Режим демона без иконки в трее (systemd/launchd) |
| — | TAIGACLAW_DATA_DIR | платформенный | Каталог данных (БД, секреты, workspace) |
Полный список env-переменных (JWT-секреты, шифрование, CORS, доверенные прокси) — в справочнике настроек.
Душа агента и профиль пользователя
Душа агента (agent → Soul) задаёт личность: имя, стиль, уровень детализации, темы для избежания, свободный текст. Профиль пользователя (User) — то, что агент должен знать о вас: имя, род занятий, предпочтения. Оба подставляются в системный промпт.
Расширенные настройки
Settings → Расширенные — 27 параметров в группах: агент (лимиты итераций), таймауты, RAG (пороги, top-K), память (интервалы консолидации и dream), аутентификация, сервер, шина. Значения по умолчанию подходят для старта; каждое снабжено описанием в интерфейсе.
Права и безопасность
По умолчанию агент не имеет доступа к инструментам (deny by default). Разрешения — на странице агента: инструменты, файловая система (workspace/whitelist/full), sandbox для команд (bubblewrap на Linux, sandbox-exec на macOS), сеть (IP-списки). Пресеты: «Ассистент», «Автоматизация», «Минимальный».
Полный референс параметров окружения, путей и флагов — справочник настроек.
Проверено на TaigaClaw 1.7.10, октябрь 2026.