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

Мастер спросит:

  1. LLM провайдер — OpenAI / Anthropic / Ollama / OpenRouter / Custom
  2. Модель — gpt-4o, claude-3.5-sonnet, llama3.1, nemotron и т.д.
  3. Каналы связи — Telegram Bot Token, WhatsApp (QR), Discord Bot Token, Slack App
  4. Права доступа — какие папки/файлы может читать/писать агент
  5. Инструменты — какие включить (файлы, браузер, терминал, календарь)

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

  1. Создайте бота у @BotFather → /newbot
  2. Скопируйте токен
  3. В мастере OpenClaw: выберите Telegram → вставьте токен
  4. Готово! Напишите боту /start

WhatsApp (через Baileys)

  1. В мастере выберите WhatsApp
  2. Отсканируйте QR-код в терминале телефоном
  3. Сессия сохраняется автоматически

Discord Bot

  1. Создайте приложение на Discord Developer Portal
  2. Bot → Reset Token → скопируйте
  3. Включите Privileged Gateway Intents (Message Content, Server Members)
  4. Invite бота на сервер (OAuth2 → bot + applications.commands)
  5. В мастере: Discord → токен

Slack App

  1. Создайте App на api.slack.com/apps
  2. OAuth & Permissions → Bot Token Scopes: chat:write, channels:read, groups:read, im:read, mpim:read
  3. Install to Workspace
  4. В мастере: Slack → Bot User OAuth Token

5. Инструменты (Tools) — что может омар

ИнструментЧто делаетПример использования
FilesystemЧтение/запись/поиск файлов"Найди все TODO в проекте", "Создай README.md"
TerminalВыполнение shell команд"Запусти тесты", "git status", "docker ps"
BrowserPlaywright автоматизация"Открой GitHub PR #42 и саммерь", "Скриншот страницы"
CalendarGoogle Cal / CalDAV / локальный"Что у меня завтра?", "Создай встречу в 15:00"
GitGit операции"Создай ветку feature/x", "Сделай коммит с сообщением..."
DockerУправление контейнерами"Перезапусти postgres", "Логи контейнера api"
SQLЗапросы к БД"Покажи последних 10 пользователей"
HTTPREST/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

ФичаOpenClawHermes AgentClaude 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. Полезные ссылки

Чек-лист первого запуска

  1. git clone && ./install.sh && openclaw
  2. Выберите LLM: Ollama (локально) или OpenRouter (облако)
  3. Подключите минимум 1 мессенджер (Telegram проще всего)
  4. Включите инструменты: Filesystem + Terminal (база)
  5. Создайте 1-2 скилла под свои рутины
  6. Протестируйте: "Омар, что у меня в календаре на завтра?"