Документация

Документация TaigaClaw — всё что нужно для начала работы и настройки.

Getting Started

Установка

TaigaClaw поставляется как один бинарник без внешних зависимостей.

Скачать

Перейдите на страницу Скачать и выберите версию для вашей платформы.

Установка из терминала (macOS / Linux)

curl -LO https://updates.taigaclaw.app/binaries/latest/taigaclaw-$(uname -s)-$(uname -m)
chmod +x taigaclaw-*
sudo mv taigaclaw-* /usr/local/bin/taigaclaw

Homebrew (macOS)

brew install taigaclaw/tap/taigaclaw

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

taigaclaw serve

Команда запустит HTTP-сервер и откроет WebUI на http://localhost:8080.

Настройка LLM

Для работы агента нужен хотя бы один LLM-провайдер. Настройте через WebUI или файл конфигурации.

Конфигурация

Файл конфигурации

TaigaClaw ищет конфигурацию в ~/.taigaclaw/config.yaml. Поддерживается подстановка переменных окружения через ${VAR}.

Структура конфига

# Провайдеры LLM
providers:
  openai:
    api_key: ${OPENAI_API_KEY}
    model: gpt-4o
    base_url: https://api.openai.com/v1  # опционально

  anthropic:
    api_key: ${ANTHROPIC_API_KEY}
    model: claude-sonnet-4-20250514

  ollama:
    base_url: http://localhost:11434
    model: llama3

# Каналы связи
channels:
  websocket:
    enabled: true
    port: 8080
  telegram:
    enabled: false
    token: ${TELEGRAM_BOT_TOKEN}

# Инструменты
tools:
  exec:
    enabled: true
    sandbox: true  # bubblewrap на Linux
  web_search:
    enabled: true
  web_fetch:
    enabled: true
    ssrf_protection: true

# Память
memory:
  consolidation:
    enabled: true
    token_threshold: 8000
  dream:
    enabled: true
    schedule: "0 3 * * *"  # ежедневно в 3:00

# Автообновление
update:
  channel: stable  # stable | beta
  check_interval: 1h
  auto_download: false

# Heartbeat
heartbeat:
  enabled: true
  interval: 30m

Переменные окружения

Переменная	Описание
`OPENAI_API_KEY`	API-ключ OpenAI
`ANTHROPIC_API_KEY`	API-ключ Anthropic
`TELEGRAM_BOT_TOKEN`	Токен Telegram-бота
`TAIGACLAW_DATA_DIR`	Каталог данных (по умолчанию `~/.taigaclaw`)

Навыки

Навыки — это markdown-файлы (SKILL.md) в директории ~/.taigaclaw/skills/. Каждый навык содержит YAML frontmatter с метаданными и инструкции для агента.

Автообновление

Обзор

TaigaClaw умеет автоматически обновляться. Механизм обеспечивает:

Целостность — SHA256 хеш бинарника
Подлинность — Ed25519 подпись манифеста
Атомарность — безопасная замена запущенного бинарника
Рестарт — supervisor-процесс автоматически перезапускает приложение

Архитектура

TaigaClaw (worker)
  └── updater.Service
        ├── Проверка манифеста (GET /stable.json)
        ├── Верификация подписи (Ed25519)
        ├── Скачивание бинарника
        ├── Проверка SHA256
        ├── selfupdate.Apply() — атомарная замена
        └── Exit code 11 → supervisor → restart

Манифест обновлений

Манифест — JSON-файл на сервере https://updates.taigaclaw.app/:

{
  "version": "0.2.0",
  "channel": "stable",
  "released_at": "2026-05-15T10:00:00Z",
  "artifacts": {
    "darwin-arm64": {
      "url": "https://updates.taigaclaw.app/binaries/v0.2.0/taigaclaw-darwin-arm64",
      "sha256": "abc123..."
    },
    "linux-amd64": {
      "url": "https://updates.taigaclaw.app/binaries/v0.2.0/taigaclaw-linux-amd64",
      "sha256": "def456..."
    }
  }
}

Рядом с манифестом — файл подписи stable.sig (Ed25519).