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 с расширенной безопасностью, мультиарендным PostgreSQL и наблюдаемостью производственного уровня.
🌐 Языки: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇪🇸 Español · 🇧🇷 Português · 🇫🇷 Français · 🇩🇪 Deutsch · 🇷🇺 Русский
- Команды агентов и оркестрация — Команды с общими досками задач, межагентная делегация (синхронная/асинхронная) и гибридное обнаружение агентов
- Мультиарендный 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
| 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 (опционально)
git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard # Интерактивный мастер настройки
source .env.local && ./goclaw# Генерация .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-конфигурации см. в Руководстве по развёртыванию.
GoClaw поддерживает команды агентов и межагентную делегацию — каждый агент работает со своей идентичностью, инструментами, провайдером LLM и контекстными файлами.
| Режим | Принцип работы | Лучше всего подходит для |
|---|---|---|
| Синхронный | Агент A обращается к агенту B и ждёт ответа | Быстрые запросы, проверка фактов |
| Асинхронный | Агент A обращается к агенту B и продолжает работу. B сообщает позже | Длинные задачи, отчёты, глубокий анализ |
Агенты общаются через явные ссылки-разрешения с управлением направлением (outbound, inbound, bidirectional) и ограничениями параллелизма как на уровне ссылки, так и на уровне агента.
- Общая доска задач — Создание, принятие, завершение, поиск задач с зависимостями
blocked_by - Командный почтовый ящик — Прямой обмен сообщениями между участниками и широковещательная рассылка
- Инструменты:
team_tasksдля управления задачами,team_messageдля почтового ящика
Подробности о делегации, ссылках-разрешениях и управлении параллелизмом см. в документации по командам агентов.
| Инструмент | Группа | Описание |
|---|---|---|
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 — или просматривайте исходники в goclaw-docs/
| Раздел | Темы |
|---|---|
| Начало работы | Установка, Быстрый старт, Конфигурация, Обзор веб-дэшборда |
| Основные концепции | Цикл агента, Сессии, Инструменты, Память, Мультиаренда |
| Агенты | Создание агентов, Контекстные файлы, Личность, Общий доступ |
| Провайдеры | Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 других |
| Каналы | Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket |
| Команды агентов | Команды, Доска задач, Обмен сообщениями, Делегация и передача управления |
| Расширенное использование | Пользовательские инструменты, MCP, Навыки, Cron, Sandbox, Хуки, RBAC |
| Развёртывание | Docker Compose, База данных, Безопасность, Наблюдаемость, Tailscale |
| Справочник | CLI-команды, REST API, WebSocket-протокол, Переменные окружения |
go test ./... # Юнит-тесты
go test -v ./tests/integration/ -timeout 120s # Интеграционные тесты (требуется запущенный шлюз)Подробный статус функций, включая то, что протестировано в продакшене и что ещё в разработке, см. в CHANGELOG.md.
GoClaw основан на оригинальном проекте OpenClaw. Мы благодарны за архитектуру и видение, которые вдохновили этот Go-порт.
MIT