GoClaw
Enterprise AI Agent Platform
Multi-agent AI gateway built in Go. 20+ LLM providers. 7 channels. Multi-tenant PostgreSQL.
Single binary. Production-tested. Agents that orchestrate for you.
Документация •
Быстрый старт •
Twitter / X
**GoClaw** — это многоагентный AI-шлюз, который подключает LLM-модели к вашим инструментам, каналам и данным — разворачивается как единый Go-бинарник без каких-либо сторонних зависимостей времени выполнения. Он оркестрирует команды агентов и межагентную делегацию через 20+ провайдеров LLM с полной мультиарендной изоляцией.
Go-порт проекта [OpenClaw](https://github.com/openclaw/openclaw) с расширенной безопасностью, мультиарендным PostgreSQL и наблюдаемостью производственного уровня.
🌐 **Языки:**
[🇺🇸 English](../README.md) ·
[🇨🇳 简体中文](README.zh-CN.md) ·
[🇯🇵 日本語](README.ja.md) ·
[🇰🇷 한국어](README.ko.md) ·
[🇻🇳 Tiếng Việt](README.vi.md) ·
[🇪🇸 Español](README.es.md) ·
[🇧🇷 Português](README.pt.md) ·
[🇫🇷 Français](README.fr.md) ·
[🇩🇪 Deutsch](README.de.md) ·
[🇷🇺 Русский](README.ru.md)
## В чём отличие
- **Команды агентов и оркестрация** — Команды с общими досками задач, межагентная делегация (синхронная/асинхронная) и гибридное обнаружение агентов
- **Мультиарендный PostgreSQL** — Отдельные рабочие пространства для каждого пользователя, контекстные файлы на пользователя, зашифрованные API-ключи (AES-256-GCM), изолированные сессии
- **Единый бинарник** — ~25 МБ статический Go-бинарник, без Node.js, запуск менее чем за 1 с, работает на VPS за $5
- **Безопасность производственного уровня** — 5-уровневая система прав (аутентификация шлюза → глобальная политика инструментов → на агента → на канал → только для владельца) плюс ограничение запросов, обнаружение prompt-инъекций, защита от SSRF, запрещённые shell-паттерны и шифрование AES-256-GCM
- **20+ провайдеров LLM** — Anthropic (нативный HTTP+SSE с кэшированием промптов), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP и любой OpenAI-совместимый эндпоинт
- **7 каналов обмена сообщениями** — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
- **Extended Thinking** — Режим thinking на каждого провайдера (бюджет токенов Anthropic, усилия рассуждения OpenAI, бюджет мышления DashScope) с поддержкой стриминга
- **Heartbeat** — Периодические проверки агентов через чек-листы HEARTBEAT.md с подавлением при успехе, активными часами, логикой повторных попыток и доставкой в канал
- **Планировщик и cron** — Выражения `at`, `every` и cron для автоматизированных задач агентов с параллелизмом на основе очередей
- **Наблюдаемость** — Встроенная трассировка LLM-вызовов со спанами и метриками кэша промптов, опциональный экспорт OpenTelemetry OTLP
## Экосистема Claw
| | OpenClaw | ZeroClaw | PicoClaw | **GoClaw** |
| --------------- | --------------- | -------- | -------- | --------------------------------------- |
| Язык | TypeScript | Rust | Go | **Go** |
| Размер бинарника | 28 МБ + Node.js | 3,4 МБ | ~8 МБ | **~25 МБ** (базовый) / **~36 МБ** (+ OTel) |
| Docker-образ | — | — | — | **~50 МБ** (Alpine) |
| ОЗУ (простой) | > 1 ГБ | < 5 МБ | < 10 МБ | **~35 МБ** |
| Запуск | > 5 с | < 10 мс | < 1 с | **< 1 с** |
| Целевое железо | Mac Mini от $599 | Edge за $10 | Edge за $10 | **VPS от $5** |
| Функция | OpenClaw | ZeroClaw | PicoClaw | **GoClaw** |
| -------------------------- | ------------------------------------ | -------------------------------------------- | ------------------------------------- | ------------------------------ |
| Мультиаренда (PostgreSQL) | — | — | — | ✅ |
| Интеграция MCP | — (использует ACP) | — | — | ✅ (stdio/SSE/streamable-http) |
| Команды агентов | — | — | — | ✅ Доска задач + почтовый ящик |
| Усиление безопасности | ✅ (SSRF, path traversal, injection) | ✅ (sandbox, rate limit, injection, pairing) | Базовая (ограничение workspace, запрет exec) | ✅ 5-уровневая защита |
| Наблюдаемость OTel | ✅ (опциональное расширение) | ✅ (Prometheus + OTLP) | — | ✅ OTLP (опциональный build tag) |
| Кэширование промптов | — | — | — | ✅ Anthropic + OpenAI-compat |
| Граф знаний | — | — | — | ✅ Извлечение LLM + обход |
| Система навыков | ✅ Embeddings/семантическая | ✅ SKILL.md + TOML | ✅ Базовая | ✅ BM25 + pgvector гибрид |
| Планировщик с очередями | ✅ | Ограниченный параллелизм | — | ✅ (main/subagent/team/cron) |
| Каналы сообщений | 37+ | 15+ | 10+ | 7+ |
| Сопутствующие приложения | macOS, iOS, Android | Python SDK | — | Веб-дэшборд |
| Live Canvas / Голос | ✅ (A2UI + TTS/STT) | — | Транскрипция голоса | TTS (4 провайдера) |
| Провайдеры LLM | 10+ | 8 нативных + 29 совместимых | 13+ | **20+** |
| Рабочие пространства на пользователя | ✅ (файловые) | — | — | ✅ (PostgreSQL) |
| Зашифрованные секреты | — (только env-переменные) | ✅ ChaCha20-Poly1305 | — (plaintext JSON) | ✅ AES-256-GCM в БД |
## Архитектура
## Быстрый старт
**Требования:** Go 1.26+, PostgreSQL 18 с pgvector, Docker (опционально)
### Из исходного кода
```bash
git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard # Интерактивный мастер настройки
source .env.local && ./goclaw
```
### С Docker
```bash
# Генерация .env с автоматически созданными секретами
chmod +x prepare-env.sh && ./prepare-env.sh
# Добавьте как минимум один GOCLAW_*_API_KEY в .env, затем:
make up
# Веб-дэшборд: http://localhost:18790
# Проверка работоспособности: curl http://localhost:18790/health
```
Если переменные окружения `GOCLAW_*_API_KEY` заданы, шлюз автоматически настраивается без интерактивных запросов — определяет провайдера, выполняет миграции и инициализирует данные по умолчанию.
> Варианты сборки (OTel, Tailscale, Redis), теги Docker-образов и дополнительные compose-конфигурации см. в [Руководстве по развёртыванию](https://docs.goclaw.sh/#deploy-docker-compose).
## Многоагентная оркестрация
GoClaw поддерживает команды агентов и межагентную делегацию — каждый агент работает со своей идентичностью, инструментами, провайдером LLM и контекстными файлами.
### Делегация агентов
| Режим | Принцип работы | Лучше всего подходит для |
|-------|----------------|--------------------------|
| **Синхронный** | Агент A обращается к агенту B и **ждёт** ответа | Быстрые запросы, проверка фактов |
| **Асинхронный** | Агент A обращается к агенту B и **продолжает работу**. B сообщает позже | Длинные задачи, отчёты, глубокий анализ |
Агенты общаются через явные **ссылки-разрешения** с управлением направлением (`outbound`, `inbound`, `bidirectional`) и ограничениями параллелизма как на уровне ссылки, так и на уровне агента.
### Команды агентов
- **Общая доска задач** — Создание, принятие, завершение, поиск задач с зависимостями `blocked_by`
- **Командный почтовый ящик** — Прямой обмен сообщениями между участниками и широковещательная рассылка
- **Инструменты**: `team_tasks` для управления задачами, `team_message` для почтового ящика
> Подробности о делегации, ссылках-разрешениях и управлении параллелизмом см. в [документации по командам агентов](https://docs.goclaw.sh/#teams-what-are-teams).
## Встроенные инструменты
| Инструмент | Группа | Описание |
| ------------------ | ------------- | ------------------------------------------------------------ |
| `read_file` | fs | Чтение содержимого файлов (с маршрутизацией виртуальной ФС) |
| `write_file` | fs | Запись/создание файлов |
| `edit_file` | fs | Точечное редактирование существующих файлов |
| `list_files` | fs | Список содержимого директории |
| `search` | fs | Поиск содержимого файлов по шаблону |
| `glob` | fs | Поиск файлов по glob-шаблону |
| `exec` | runtime | Выполнение shell-команд (с рабочим процессом подтверждения) |
| `web_search` | web | Поиск в интернете (Brave, DuckDuckGo) |
| `web_fetch` | web | Получение и парсинг веб-контента |
| `memory_search` | memory | Поиск в долгосрочной памяти (FTS + vector) |
| `memory_get` | memory | Извлечение записей из памяти |
| `skill_search` | — | Поиск навыков (гибрид BM25 + embedding) |
| `knowledge_graph_search` | memory | Поиск сущностей и обход связей графа знаний |
| `create_image` | media | Генерация изображений (DashScope, MiniMax) |
| `create_audio` | media | Генерация аудио (OpenAI, ElevenLabs, MiniMax, Suno) |
| `create_video` | media | Генерация видео (MiniMax, Veo) |
| `read_document` | media | Чтение документов (Gemini File API, цепочка провайдеров) |
| `read_image` | media | Анализ изображений |
| `read_audio` | media | Транскрипция и анализ аудио |
| `read_video` | media | Анализ видео |
| `message` | messaging | Отправка сообщений в каналы |
| `tts` | — | Синтез речи (Text-to-Speech) |
| `spawn` | — | Запуск субагента |
| `subagents` | sessions | Управление запущенными субагентами |
| `team_tasks` | teams | Общая доска задач (список, создание, принятие, завершение, поиск) |
| `team_message` | teams | Командный почтовый ящик (отправка, рассылка, чтение) |
| `sessions_list` | sessions | Список активных сессий |
| `sessions_history` | sessions | Просмотр истории сессий |
| `sessions_send` | sessions | Отправка сообщения в сессию |
| `sessions_spawn` | sessions | Запуск новой сессии |
| `session_status` | sessions | Проверка статуса сессии |
| `cron` | automation | Планирование и управление cron-заданиями |
| `gateway` | automation | Администрирование шлюза |
| `browser` | ui | Автоматизация браузера (навигация, клик, ввод, скриншот) |
| `announce_queue` | automation | Объявление асинхронных результатов (для асинхронных делегаций) |
## Документация
Полная документация на **[docs.goclaw.sh](https://docs.goclaw.sh)** — или просматривайте исходники в [`goclaw-docs/`](https://github.com/nextlevelbuilder/goclaw-docs)
| Раздел | Темы |
|--------|------|
| [Начало работы](https://docs.goclaw.sh/#what-is-goclaw) | Установка, Быстрый старт, Конфигурация, Обзор веб-дэшборда |
| [Основные концепции](https://docs.goclaw.sh/#how-goclaw-works) | Цикл агента, Сессии, Инструменты, Память, Мультиаренда |
| [Агенты](https://docs.goclaw.sh/#creating-agents) | Создание агентов, Контекстные файлы, Личность, Общий доступ |
| [Провайдеры](https://docs.goclaw.sh/#providers-overview) | Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 других |
| [Каналы](https://docs.goclaw.sh/#channels-overview) | Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket |
| [Команды агентов](https://docs.goclaw.sh/#teams-what-are-teams) | Команды, Доска задач, Обмен сообщениями, Делегация и передача управления |
| [Расширенное использование](https://docs.goclaw.sh/#custom-tools) | Пользовательские инструменты, MCP, Навыки, Cron, Sandbox, Хуки, RBAC |
| [Развёртывание](https://docs.goclaw.sh/#deploy-docker-compose) | Docker Compose, База данных, Безопасность, Наблюдаемость, Tailscale |
| [Справочник](https://docs.goclaw.sh/#cli-commands) | CLI-команды, REST API, WebSocket-протокол, Переменные окружения |
## Тестирование
```bash
go test ./... # Юнит-тесты
go test -v ./tests/integration/ -timeout 120s # Интеграционные тесты (требуется запущенный шлюз)
```
## Статус проекта
Подробный статус функций, включая то, что протестировано в продакшене и что ещё в разработке, см. в [CHANGELOG.md](CHANGELOG.md).
## Благодарности
GoClaw основан на оригинальном проекте [OpenClaw](https://github.com/openclaw/openclaw). Мы благодарны за архитектуру и видение, которые вдохновили этот Go-порт.
## Лицензия
MIT