OpenClaw Ops — Полная поддержка Фабрики Контента

Всё про OpenClaw и Фабрику: установка, настройка, диагностика, фиксы, обновления, скиллы, агенты. Самый короткий путь к решению.

Когда использовать

• Установка и первый запуск OpenClaw / Фабрики
• Бот не отвечает / не видит сообщения / ошибки
• Настройка агентов, каналов, моделей
• Обновление скиллов и OpenClaw
• Бэкап и восстановление конфига
• Любой вопрос "как сделать X в OpenClaw"
• Помощь с онбордингом нового участника
• Диагностика и фиксы любых проблем

File Router

Архитектура (кратко)

OpenClaw = Gateway (сервер) + Agents (ИИ-агенты) + Channels (Telegram, Discord...)

Telegram → Gateway → выбирает агента по binding → агент думает → ответ → Telegram

Конфиг: ~/.openclaw/openclaw.json (ВСЁ настраивается тут)
Агенты: каждый в своей папке (workspace) с SOUL.md
Скиллы: ./skills/ в workspace каждого агента или ~/.openclaw/skills/

Три уровня системы

СКИЛЛ (skills/)     → "КАК делать"  (рецепт/методика)
       ↓
АГЕНТ (agents/)     → "КТО делает"  (роль/специалист)
       ↓
ПРОЕКТ (projects/)  → "ДЛЯ КОГО"   (конкретный эксперт)

Что есть что

• Claude Code — терминальный AI-ассистент от Anthropic. Работает локально на компе
• OpenClaw — платформа для запуска AI-агентов в Telegram. Работает 24/7 на VPS
• Фабрика Контента — набор скиллов и настроек. Ставится поверх Claude Code ИЛИ OpenClaw
• Агенты Claude Code и агенты OpenClaw — совершенно разные вещи. Можно совмещать

Быстрая установка

Порядок установки (правильный)

1. Node.js 18+ → node -v (если нет: macOS brew install node, Linux/Windows — nodejs.org)
2. OpenClaw → npm install -g openclaw
3. Первый запуск → openclaw init (wizard)
4. Telegram бот → @BotFather → /newbot → получить токен
5. Фабрика → curl -sSL https://открой Telegram-бота Фабрики Контента
6. Старт → openclaw gateway start

❌ НЕ используй git clone / git pull — установщик единственная система обновления.

Как обновить

Одна команда для всех тарифов:

curl -sSL https://открой Telegram-бота Фабрики Контента

Скрипт сам определяет тариф по токену. Обновит только скиллы — НЕ трогает brand/, learning/ и настройки. После обновления: openclaw gateway restart

❌ Старые ссылки НЕ использовать (factory-api-endpoint/5agents, /vip-factory, /update и т.д.)

Или через factory CLI: factory update

Конфиг (openclaw.json)

Путь: ~/.openclaw/openclaw.json

Эталонный конфиг

{
  "model": "anthropic/claude-sonnet-4-6",
  "auth": {
    "providers": [
      {
        "type": "api-key",
        "provider": "anthropic",
        "apiKey": "sk-ant-api03-..."
      }
    ]
  },
  "agents": {
    "defaults": {
      "thinking": "high",
      "thinkingDefault": "high",
      "streaming": "partial",
      "imageMaxDimensionPx": 1120
    }
  },
  "channels": {
    "telegram": {
      "token": "123456789:AAF...",
      "dmPolicy": "allow"
    }
  },
  "skills": ["./skills"],
  "memory": {
    "memorySearch": true
  },
  "compaction": {
    "mode": "safeguard",
    "memoryFlush": {
      "enabled": true
    }
  }
}

Ключевые настройки

Подробный чеклист аудита конфига → references/config-audit.md

Быстрая диагностика

Бот не отвечает — 5 шагов

Шаг 1: openclaw gateway status
  → Запущен? Если НЕТ → openclaw gateway start

Шаг 2: openclaw doctor
  → Покажет проблемы

Шаг 3: openclaw gateway restart
  → 80% проблем решается рестартом

Шаг 4: Проверь логи
  openclaw gateway logs --tail 50
  → Ищи "error", "unauthorized", "timeout"

Шаг 5: factory doctor
  → 10 проверок системы

Самые частые ошибки и решения

Полный справочник с деревьями решений → references/troubleshooting.md

Как узнать свой Telegram ID

1. Написать боту @userinfobot в Telegram
2. Он ответит твой ID (число)
3. Вставить в allowFrom в конфиг

Как создать Telegram бота

1. Открыть @BotFather → /newbot → имя → username (на "bot")
2. Скопировать токен (вида 123456789:AAF...)
3. Вставить в конфиг
4. Между созданием ботов ждать 5-10 мин (лимит BotFather)

Авторизация: API vs Подписка

Как определить что у пользователя

Подключение подписки (oat-токен)

# 1. На Mac (не VPS!):
npm install -g @anthropic-ai/claude-code
claude /login  # OAuth через браузер

# 2. Достать токен:
security find-generic-password -s "Claude Code-credentials" -a "USERNAME" -w
# Скопировать accessToken (sk-ant-oat01-...)

# 3. На VPS:
openclaw models auth paste-token --provider anthropic
# Вставить oat01 токен

# 4. Перезапуск
openclaw gateway restart

Проверка: openclaw models status → anthropic: ok

Важно: НЕ вставляй API key (sk-ant-api03-) туда, где нужен OAuth (sk-ant-oat01-) и наоборот!

auth-profiles.json для нескольких агентов

openclaw models auth paste-token --provider anthropic сохраняет для всех агентов.

Если у агента есть отдельный agentDir — глобальный auth-profiles.json НЕ подхватывается. Нужен файл в agentDir:

ln -sf ~/.openclaw/auth-profiles.json ~/.openclaw/agents/[agent]/agent/auth-profiles.json

Обновление

# Проверить текущую версию
openclaw --version

# Обновить OpenClaw
npm update -g openclaw

# Обновить скиллы Фабрики
curl -sSL https://открой Telegram-бота Фабрики Контента

# Или через factory CLI
factory update

# Перезапустить
openclaw gateway restart

Бэкап и восстановление

⚠️ ПРЕДОХРАНИТЕЛЬ

openclaw doctor --fix может ПЕРЕЗАПИСАТЬ конфиг, удалив настройки агентов!

# ВСЕГДА перед doctor --fix:
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

# Если doctor сломал конфиг:
cp ~/.openclaw/openclaw.json.backup ~/.openclaw/openclaw.json
openclaw gateway restart

Регулярный бэкап

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

Если установщик перезаписал конфиг

# OpenClaw хранит до 4 бэкапов:
ls ~/.openclaw/openclaw.json.bak*
cp ~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json
openclaw gateway restart

Память (Memory)

Как работает

• Каждый агент имеет MEMORY.md + memory/ папку
• memory/YYYY-MM-DD.md — дневные логи
• learning/ — паттерны и антипаттерны
• При перезапуске агент читает MEMORY.md → помнит контекст

Настройка

"memorySearch": {
  "enabled": true,
  "provider": "openai",
  "model": "text-embedding-3-small"
}

Compaction (сжатие контекста)

"compaction": {
  "mode": "safeguard",
  "memoryFlush": {
    "enabled": true
  }
}

safeguard = агент автоматически сохраняет контекст перед сжатием. БЕЗ ЭТОГО память теряется!

Агент не помнит что было вчера

Это нормально — сессия = текущий диалог. При рестарте gateway сессии сбрасываются.

Что делать:

1. Важное записывай в MEMORY.md — агент читает его при каждом старте
2. Результаты работы → memory/YYYY-MM-DD.md
3. Для автоматического сохранения: включи memoryFlush

Межагентное взаимодействие

Включение

"agentToAgent": {
  "enabled": true,
  "allow": ["coordinator", "copywriter", "marketer", "designer", "techie"]
}

Как работает

• Координатор отправляет задачу копирайтеру через sessions_send
• Агенты видят друг друга через sessions_list
• Каждый агент изолирован (свой workspace, своя память)
• Боты друг друга НЕ видят в группах Telegram — это ограничение Telegram

Настройка 5 агентов

Для 5 агентов нужно 5 отдельных Telegram-ботов через @BotFather.

Каждый бот привязан к своему агенту через bindings:

{
  "bindings": [
    { "agentId": "coordinator", "match": { "channel": "telegram", "accountId": "coordinator-bot" } },
    { "agentId": "copywriter", "match": { "channel": "telegram", "accountId": "copywriter-bot" } },
    { "agentId": "designer", "match": { "channel": "telegram", "accountId": "designer-bot" } },
    { "agentId": "marketer", "match": { "channel": "telegram", "accountId": "marketer-bot" } },
    { "agentId": "techie", "match": { "channel": "telegram", "accountId": "techie-bot" } }
  ]
}

Два бота в группе — requireMention

Чтобы боты видели ВСЕ сообщения, но отвечали ТОЛЬКО когда тегнут:

{
  "channels": {
    "telegram": {
      "groupPolicy": "open",
      "groups": {
        "-100XXXXXX": { "requireMention": true }
      }
    }
  }
}

Где хранятся файлы агента

Рабочая директория (workspace) — ~/openclaw-ai/<agent>/

• SOUL.md — личность, инструкции, правила
• MEMORY.md — долгосрочная память
• memory/ — ежедневные логи
• learning/ — антипаттерны, коррекции
• brand/ — профиль эксперта
• skills/ — скиллы (наивысший приоритет)

Служебная директория — ~/.openclaw/agents/<agent>/

• sessions/ — логи сессий (НЕ трогай)
• qmd/ — индексы для поиска
• agent/ — auth, кэш

Размер служебки: ~100-400 МБ на агента. Если удалить — пересоздаст, но потеряются логи.

CLI команды (справочник)

OpenClaw

Factory CLI

Стоимость

Подписка Фабрики

Стоимость ИИ (отдельно)

Дополнительно: LaoZhang для картинок ($1-5/мес), VPS ($5+/мес), MoreLogin ($9+/мес)

$100 vs $200 подписка

• $100/мес = ~$1350 эквивалент API
• $200/мес = ровно вдвое больше лимитов. НЕ безлимит
• Лимиты бывают часовые, дневные и недельные

Безопасность — 4 проверки

Экономия токенов

1. Отключи heartbeat у неосновных агентов: openclaw config set agents.defaults.heartbeat.interval "0"
2. Ограничь сессии: openclaw config set agents.defaults.session.maxAge "4h"
3. SOUL.md — максимум 100-150 строк
4. Не отправляй тяжёлые файлы — жрут контекст
5. /restart когда контекст раздут

Основные команды конструктора

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

• Полная документация: https://docs.openclaw.ai
• База знаний Фабрики: https://factory-site
• Скиллы: https://clawhub.com
• Доступ: Telegram-бот?start=access
• Партнёрская программа: https://factory-site/start/affiliate/

OpenClaw Ops v2.0 — интегрирована база знаний поддержки Фабрики Контента