OpenClaw: полное руководство по локальному AI-ассистенту
OpenClaw — это open-source AI-ассистент, который живёт на вашей машине и интегрируется в ваши каналы общения. Маскот — омар 🦞 (лобстер). Ключевая фишка: данные не уходят в облако, в сеть идут только вызовы LLM API.
1. Архитектура и философия
- Ядро: Rust (быстрое, безопасное, кроссплатформенное)
- Плагины: TypeScript / Python (легко расширять)
- LLM-адаптеры: OpenAI, Anthropic, Ollama, llama.cpp, LM Studio, vLLM, OpenRouter
- Транспорты: Telegram, WhatsApp (Baileys), Discord, Slack, Matrix, локальный CLI, веб-интерфейс
- Инструменты (tools): файловая система, календарь, браузер (Playwright), терминал, Git, Docker, SQL, HTTP клиент
Репозиторий: github.com/openclaw/openclaw (394k ★)
2. Быстрый старт (5 минут)
Предварительные требования
- Rust 1.75+ (
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh) - Node.js 20+ (для плагинов и веб-UI)
- Git
- Опционально: Ollama (
curl -fsSL https://ollama.ai/install.sh | sh) для локальных моделей
Установка
git clone https://github.com/openclaw/openclaw
cd openclaw
./install.sh # ставит зависимости, конфигурирует, собирает
# Первый запуск — интерактивный мастер настройки
openclaw
Мастер спросит:
- LLM провайдер — OpenAI / Anthropic / Ollama / OpenRouter / Custom
- Модель — gpt-4o, claude-3.5-sonnet, llama3.1, nemotron и т.д.
- Каналы связи — Telegram Bot Token, WhatsApp (QR), Discord Bot Token, Slack App
- Права доступа — какие папки/файлы может читать/писать агент
- Инструменты — какие включить (файлы, браузер, терминал, календарь)
3. Настройка LLM провайдеров
OpenAI / Anthropic / OpenRouter
# В мастере выберите провайдера, введите API ключ
# OpenRouter даёт доступ к 100+ моделей одним ключом
# Бесплатные модели: выбирайте с суффиксом :free
Локальные модели через Ollama (рекомендуется для приватности)
# Установка Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# Скачайте модели
ollama pull llama3.1:8b # быстрая, умная
ollama pull nemotron3:8b # отличная для кода
ollama pull qwen2.5:7b # хорошая мультиязычная
ollama pull codellama:7b # специализированная для кода
В мастере OpenClaw выберите "Ollama" → модель из списка.
llama.cpp (ещё быстрее на CPU)
# OpenClaw поддерживает llama.cpp напрямую
# Укажите путь к .gguf файлу в настройках
4. Подключение мессенджеров
Telegram Bot
- Создайте бота у @BotFather →
/newbot - Скопируйте токен
- В мастере OpenClaw: выберите Telegram → вставьте токен
- Готово! Напишите боту /start
WhatsApp (через Baileys)
- В мастере выберите WhatsApp
- Отсканируйте QR-код в терминале телефоном
- Сессия сохраняется автоматически
Discord Bot
- Создайте приложение на Discord Developer Portal
- Bot → Reset Token → скопируйте
- Включите Privileged Gateway Intents (Message Content, Server Members)
- Invite бота на сервер (OAuth2 → bot + applications.commands)
- В мастере: Discord → токен
Slack App
- Создайте App на api.slack.com/apps
- OAuth & Permissions → Bot Token Scopes: chat:write, channels:read, groups:read, im:read, mpim:read
- Install to Workspace
- В мастере: Slack → Bot User OAuth Token
5. Инструменты (Tools) — что может омар
| Инструмент | Что делает | Пример использования |
|---|---|---|
| Filesystem | Чтение/запись/поиск файлов | "Найди все TODO в проекте", "Создай README.md" |
| Terminal | Выполнение shell команд | "Запусти тесты", "git status", "docker ps" |
| Browser | Playwright автоматизация | "Открой GitHub PR #42 и саммерь", "Скриншот страницы" |
| Calendar | Google Cal / CalDAV / локальный | "Что у меня завтра?", "Создай встречу в 15:00" |
| Git | Git операции | "Создай ветку feature/x", "Сделай коммит с сообщением..." |
| Docker | Управление контейнерами | "Перезапусти postgres", "Логи контейнера api" |
| SQL | Запросы к БД | "Покажи последних 10 пользователей" |
| HTTP | REST/GraphQL запросы | "Позови API погоды для Москвы" |
Инструменты включаются/выключаются в мастере или в ~/.config/openclaw/tools.toml.
6. Скиллы (Skills) — процедурная память
Скиллы в OpenClaw — это Markdown-файлы с YAML-frontmatter (как в Hermes), загружаемые по триггеру.
# ~/.config/openclaw/skills/my-deploy.md
---
name: my-deploy
description: "Use when user wants to deploy to production. Runs full pipeline."
tools: [Terminal, Git, HTTP]
---
Deploy procedure:
1. Run tests: npm run test
2. Build: npm run build
3. Check bundle size
4. Deploy: npm run deploy
5. Verify: curl https://myapp.com/health
6. Notify in Telegram: "Deploy done!"
Rollback on failure:
- git revert HEAD
- npm run deploy
- Notify: "Rollback done"
Положите файл в ~/.config/openclaw/skills/ — агент подхватит автоматически.
7. Конфигурация (продвинутая)
Основной конфиг: ~/.config/openclaw/config.toml
[agent]
name = "Claw"
personality = "helpful, concise, slightly sarcastic"
language = "ru"
[llm]
provider = "ollama"
model = "llama3.1:8b"
temperature = 0.3
max_tokens = 4096
[tools]
filesystem = { enabled = true, allowed_paths = ["/home/user/projects", "/home/user/docs"] }
terminal = { enabled = true, allow_sudo = false }
browser = { enabled = true, headless = true }
calendar = { enabled = true, provider = "google", credentials = "/path/to/creds.json" }
[memory]
type = "sqlite"
path = "~/.config/openclaw/memory.db"
retention_days = 365
[privacy]
telemetry = false
local_only = true # блокирует внешние вызовы, кроме LLM
8. Сравнение: OpenClaw vs Hermes vs Claude Code
| Фича | OpenClaw | Hermes Agent | Claude Code |
|---|---|---|---|
| Где живёт | Локально (ваш ПК/сервер) | Локально (Python) | Локально (Node/Rust CLI) |
| Мессенджеры | ✅ WhatsApp, Telegram, Discord, Slack | ✅ Telegram (встроено) | ❌ Только терминал |
| Кастомизация | Плагины TS/Python, конфиг TOML | Скиллы (Markdown+YAML) | Subagents, hooks, slash-cmds |
| Инструменты | Файлы, терминал, браузер, календарь, Git, Docker, SQL | Браузер, терминал, поиск, GitHub | Файлы, терминал, bash, MCP |
| Память | SQLite (долгая) + контекст | SQLite (skills + facts) | CLAUDE.md + контекст |
| Приватность | Максимальная (local-only mode) | Высокая | Зависит от настроек |
| Код | Через инструменты (терминал, LSP) | Через скиллы | Нативная работа с кодом |
| Сложность входа | Средняя (мастер настройки) | Низкая (pip install) | Низкая (npm install) |
| Лучше для | Персональный ассистент в мессенджерах, автоматизация жизни | Оркестрация задач в чате, скиллы | Работа с кодом в репо, CI/CD |
9. Частые проблемы и решения
- Омар не отвечает в Telegram — проверьте токен, вебхук (OpenClaw использует long polling), логи:
openclaw logs - Ollama модель не найдена —
ollama list, проверьте точное имя в конфиге - WhatsApp QR не сканируется — перезапустите
openclaw, иногда Baileys глючит - Нет прав на файлы — добавьте пути в
config.toml→tools.filesystem.allowed_paths - Высокое потребление памяти — используйте меньшие модели (qwen2.5:3b, phi3:mini)
10. Полезные ссылки
- Репозиторий: github.com/openclaw/openclaw
- Документация: docs.openclaw.dev (если есть)
- Discord сообщество: discord.gg/openclaw
- Релизы: GitHub Releases
- Примеры скиллов: examples/skills
- Плагины: plugins/
Чек-лист первого запуска
git clone && ./install.sh && openclaw- Выберите LLM: Ollama (локально) или OpenRouter (облако)
- Подключите минимум 1 мессенджер (Telegram проще всего)
- Включите инструменты: Filesystem + Terminal (база)
- Создайте 1-2 скилла под свои рутины
- Протестируйте: "Омар, что у меня в календаре на завтра?"
