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

OpenClaw CRM помогает вести учёт людей, компаний, сделок, задач и заметок в одном месте. Встроенный AI-ассистент позволяет запрашивать и обновлять данные на обычном языке — без написания запросов и изучения нового интерфейса.

OpenClaw — проект с открытым кодом (лицензия MIT), доступный в двух вариантах:

• Облачный: зарегистрируйтесь и начните работу сразу. Данные хранятся на наших серверах, обновления происходят автоматически, ничего устанавливать не нужно.
• На своём сервере: клонируйте репозиторий и запустите на своей инфраструктуре. Полный контроль над данными. Подробности в разделе Свой сервер.

В обоих случаях вы получаете полнофункциональную CRM без оплаты за рабочие места и без платных функций. Обзор места OpenClaw на рынке можно прочитать в статье Какие CRM с открытым кодом работают с AI-агентами? или сравнить с HubSpot, Attio, Folk и Salesforce. Фрилансерам и предпринимателям будет полезна статья CRM для фрилансеров.

Регистрация

1. Нажмите Начать на главной странице.
2. Введите имя, email и пароль (минимум 8 символов). Также можно войти через GitHub или Google, если настроен OAuth.
3. Задайте название рабочего пространства — это общее пространство вашей команды. Если оставить пустым, будет «Пространство [Ваше имя]».
4. Нажмите Создать пространство. Вы попадёте на главную страницу.

Что создаётся автоматически

Каждое новое пространство содержит три стандартных объекта:

• Контакты: с полями имя, email, телефон, должность, компания, местоположение и описание.
• Компании: название, домены (сайты), описание, команда (связанные контакты), адрес и категории.
• Сделки: название, сумма, стадия, ожидаемая дата закрытия, связанная компания и контакты. Шесть стадий воронки готовы к использованию: Лид, Квалификация, Предложение, Переговоры, Выиграна, Проиграна.

Главная страница

После входа вы попадаете на главную страницу. Она показывает приветствие с текущей датой, быструю статистику (контакты, компании, сделки, открытые задачи), последние задачи с индикаторами просрочки, недавние заметки и просмотренные записи.

Новые пользователи видят чеклист с четырьмя рекомендуемыми первыми шагами. Каждый шаг можно скрыть отдельно или весь чеклист сразу. Он исчезает автоматически после добавления первых записей.

Перед вводом данных потратьте 5 минут на эти четыре вещи. Они значительно улучшат дальнейшую работу.

1. Навигация по приложению

Боковая панель слева — основная навигация. Вверху объекты (Контакты, Компании, Сделки и пользовательские объекты). Ниже — Задачи, Заметки, Списки, Чат и Поиск. Настройки — в самом низу.

Нажмите Ctrl+K (или Cmd+K на Mac), чтобы открыть командную палитру. Можно искать записи, переходить на любую страницу или создать новую запись, не отрывая рук от клавиатуры.

2. Настройка AI-чата

AI-чат — самый быстрый способ запрашивать данные и выполнять массовые действия. Для его включения нужен ключ OpenRouter. OpenRouter — бесплатный сервис, дающий доступ к Claude, GPT-4o, Llama, Gemini и другим моделям через один ключ.

1. Зайдите на openrouter.ai/keys и создайте бесплатный аккаунт. Сгенерируйте API-ключ.
2. В OpenClaw перейдите в Настройки > AI в боковой панели.
3. Вставьте ключ в поле OpenRouter API Key.
4. Выберите модель. Claude Sonnet 4 — по умолчанию, хорошо подходит для большинства задач. GPT-4o Mini или Gemini 2.0 Flash — бюджетные варианты.
5. Нажмите Сохранить, затем Проверить подключение, чтобы убедиться что всё работает.

После настройки откройте Чат в боковой панели. Можно спрашивать «Сколько сделок на стадии Переговоров?» или «Создай контакт Иван Петров из компании Acme» — AI всё сделает.

3. Загрузите свои данные

Есть два способа добавить записи. Выберите подходящий.

Ручной ввод: откройте Контакты, Компании или Сделки в боковой панели и нажмите + Новая запись. Заполните поля и нажмите Создать. Подходит для небольшого числа записей или при создании CRM с нуля.

Импорт из CSV: если данные уже есть в таблице (Excel, Google Sheets, другая CRM), экспортируйте их в CSV и используйте инструмент импорта:

1. Откройте нужный объект (например, Контакты).
2. Нажмите кнопку Импорт на панели инструментов.
3. Перетащите или выберите CSV-файл. Первая строка должна содержать заголовки столбцов.
4. Появится экран сопоставления столбцов. Каждая строка показывает заголовок CSV и выпадающий список для выбора соответствующего поля CRM. Если заголовки совпадают с названиями полей — они сопоставляются автоматически.
5. Не обязательно сопоставлять все столбцы — пропустите те, для которых нет подходящего поля.
6. Нажмите Импорт. До 1 000 записей за раз. При ошибках вы увидите список с номерами строк для исправления.

4. Пригласите команду

Если CRM будет использовать несколько человек, пригласите их сейчас.

1. Перейдите в Настройки > Участники.
2. Введите email коллеги в поле Добавить участника.
3. Выберите роль: Админ (может менять настройки, управлять участниками и создавать API-ключи) или Участник (полный доступ к данным CRM, но не может менять настройки пространства).
4. Нажмите Добавить. Коллега сможет войти сразу.

Роли можно менять или удалять участников в любое время на той же странице.

OpenClaw CRM напрямую подключается к вашему OpenClaw Bot. Сгенерируйте файл скилла, добавьте его в конфиг агента — и агент сможет создавать контакты, обновлять сделки, вести заметки, искать данные и управлять задачами откуда угодно.

Генерация файла скилла

1. Перейдите в Настройки > API-ключи и создайте ключ.
2. Перейдите в Настройки > OpenClaw.
3. Пройдите 4-шаговый мастер генерации файла скилла. Он содержит базовый URL вашей CRM, авторизацию и все 19 категорий API-эндпоинтов.
4. Нажмите Скачать для сохранения файла.

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

1. Скопируйте скачанный файл в ~/.openclaw/skills/openclaw/SKILL.md
2. Добавьте ссылку на скилл в конфиг openclaw.json.
3. Перезапустите OpenClaw Bot.

Проверка

Спросите агента: «Покажи все объекты в CRM». Он должен вернуть Контакты, Компании и Сделки (плюс пользовательские объекты). Попробуйте ещё:

• «Добавь контакт Иван Петров из компании Acme»
• «Покажи все сделки, закрывающиеся в этом месяце»
• «Создай задачу — перезвонить Сергею во вторник»

Полное пошаговое руководство: туториал по подключению.

Контакты и Компании — два основных типа записей. Каждый представляет собой таблицу с настраиваемыми полями («атрибутами»). Записи обоих типов могут быть связаны между собой и со сделками.

Стандартные поля

Контакты: Имя, Email, Телефон, Должность, Компания (ссылка на компанию), Местоположение и Описание.

Компании: Название, Домены (сайты), Описание, Команда (связанные контакты), Основной адрес и Категории.

Добавление записи

1. Откройте Контакты или Компании в боковой панели.
2. Нажмите + Новая запись (правый верхний угол).
3. Заполните поля. Обязательные поля отмечены.
4. Нажмите Создать. Страница записи откроется автоматически.

Карточка записи

Нажмите на любую запись, чтобы открыть полную карточку. Вы увидите пять вкладок:

• Обзор: все поля и их текущие значения. Нажмите на значение, чтобы отредактировать. Enter или клик в сторону — для сохранения.
• Связанные записи: связанные контакты, компании или сделки. Здесь можно добавить связи.
• Активность: хронология всех изменений записи — кто что и когда изменил.
• Заметки: текстовые заметки, прикреплённые к этой записи.
• Задачи: задачи, привязанные к записи, с дедлайнами и ответственными.

Типы атрибутов

OpenClaw CRM поддерживает 17 типов атрибутов: текст, число, валюта, дата, время, чекбокс, выбор (выпадающий список), статус, рейтинг, email, телефон, домен (сайт), местоположение, имя, ссылка на запись, ссылка на пользователя и взаимодействие. При добавлении пользовательского поля вы выбираете из этого списка.

Сделки отслеживают возможности продаж. Встроенная Kanban-доска позволяет видеть, на какой стадии находится каждая сделка.

Стандартные стадии воронки

Каждое новое пространство содержит шесть стадий: Лид, Квалификация, Предложение, Переговоры, Выиграна и Проиграна. Перемещение сделки в стадию «Выиграна» запускает анимацию победы. Стадии можно переименовывать, менять порядок, цвет или удалять.

Создание сделки

1. Откройте Сделки в боковой панели.
2. Нажмите + Новая запись.
3. Заполните название сделки, сумму (в любой валюте), стадию, ожидаемую дату закрытия и при необходимости свяжите компанию и контакты.
4. Нажмите Создать.

Kanban-доска

Переключитесь в вид Доска с помощью переключателя вверху страницы Сделок. Каждый столбец — стадия воронки. Перетаскивайте карточки между столбцами для перемещения по воронке. Внутри столбца можно менять порядок карточек для обозначения приоритета. Общая сумма сделок в каждой стадии отображается в заголовке столбца.

Настройка стадий

Перейдите в Настройки > Объекты, раскройте Сделки и отредактируйте атрибут «Стадия». Можно добавлять новые стадии, переименовывать, менять цвета, порядок и отмечать, какие стадии «активные» (открытая воронка), а какие — закрытые (выиграна или проиграна).

OpenClaw CRM имеет встроенного AI-ассистента, который может читать и записывать данные CRM на обычном языке. Работает через OpenRouter — можно использовать Claude, GPT-4o, Llama, Gemini и другие модели.

Настройка AI

Подробности в разделе Базовая настройка. Вкратце: получите бесплатный ключ OpenRouter, вставьте его в Настройки > AI, выберите модель и нажмите Сохранить.

Что умеет AI

AI имеет 13 инструментов. 8 — для чтения (работают мгновенно). 5 — для записи (запрашивают подтверждение перед изменениями).

Инструменты чтения (мгновенные, без подтверждения):

• Поиск записей по имени, email, домену или любому тексту
• Список всех типов объектов и их атрибутов
• Просмотр записей определённого типа (контакты, компании, сделки)
• Просмотр конкретной записи по ID со всеми полями
• Показ открытых и завершённых задач
• Получение заметок, привязанных к записи
• Список всех списков пространства
• Получение записей из конкретного списка

Инструменты записи (требуют подтверждения):

• Создание новых записей (контакты, компании, сделки, пользовательские объекты)
• Обновление полей существующих записей
• Удаление записей
• Создание задач и привязка к записям
• Добавление заметок к записям

Примеры запросов

• «Покажи все сделки, закрывающиеся в этом месяце»
• «Какова общая сумма воронки?»
• «Сколько контактов мы добавили на этой неделе?»
• «Кто контакты в компании Acme?»
• «Добавь заметку о звонке к Сергею Петрову»
• «Создай контакт: Иван Иванов, ivan@example.com»
• «Переведи сделку Acme в стадию Переговоры»
• «Создай задачу — позвонить Смирнову до пятницы»

Как работают подтверждения

Когда AI планирует действие записи (создание, обновление или удаление), он описывает, что именно собирается сделать, и ждёт вашего одобрения. Можно подтвердить, попросить изменить детали или отменить. Ничего не меняется в базе данных, пока вы не дадите явное согласие.

Хотите узнать подробнее? Два способа работы AI в OpenClaw CRM — сравнение встроенного ассистента и внешнего агента.

Разговоры

Каждая сессия чата — отдельный разговор. Можно начинать новые разговоры из боковой панели на странице Чата, переключаться между прошлыми разговорами или удалять ненужные. AI помнит контекст в рамках разговора — можно ссылаться на записи, упомянутые ранее.

Задачи помогают отслеживать дела. Каждую задачу можно привязать к одной или нескольким записям (контакту, компании, сделке или пользовательскому объекту), чтобы всегда был контекст.

Создание задачи

1. Откройте Задачи в боковой панели или нажмите Добавить задачу на карточке записи (вкладка Задачи).
2. Введите описание задачи.
3. При необходимости укажите дедлайн и ответственного (любой участник пространства).
4. При необходимости привяжите задачу к записям через поиск.
5. Нажмите Создать.

Управление задачами

Нажмите на кружок рядом с задачей, чтобы отметить её выполненной. Страница Задач показывает все открытые задачи с красными индикаторами просрочки. Виджет на главной показывает 10 последних задач для быстрого контроля. Задачи, привязанные к записи, также отображаются на карточке записи во вкладке Задачи.

Заметки — форматированный текст, привязанный к любой записи. Используйте их для итогов встреч, журнала звонков, предложений или любой свободной информации рядом с контактом или сделкой.

Создание заметки

1. Откройте запись и нажмите вкладку Заметки.
2. Нажмите + Новая заметка.
3. Напишите заметку в редакторе. Доступно форматирование: жирный, курсив, заголовки (H1–H3), маркированные и нумерованные списки, ссылки и другое.
4. Заметки сохраняются автоматически при наборе.

Просмотр всех заметок

Страница Заметки в боковой панели показывает все заметки пространства, сгруппированные по дате: Сегодня, Вчера, На этой неделе и Ранее. Нажмите на заметку, чтобы открыть боковую панель для быстрого чтения или редактирования.

Списки — вручную составленные коллекции записей. Считайте их сохранёнными группами: «VIP-клиенты», «Лиды Q1», «Участники конференции» или «Партнёры».

Создание списка

1. В боковой панели под Списки нажмите значок +.
2. Задайте название и выберите тип объекта (Контакты, Компании, Сделки или пользовательский объект).
3. Нажмите Создать.

Добавление записей в список

Откройте список, нажмите + Добавить запись и найдите нужные записи через поиск. Можно добавить сколько угодно.

Атрибуты списка

У списков могут быть собственные атрибуты (столбцы), действующие только в рамках списка — полезно для данных, актуальных в контексте списка, но не для записи в целом. Например, список «Лиды Q1» может иметь столбцы «Приоритет» или «Дата follow-up», которые существуют только в этом списке, а не в объекте Контакты.

Импорт из CSV

Массовый импорт записей из CSV-файла в любой тип объекта — самый быстрый способ миграции из другой CRM, таблицы или экспорта данных.

1. Откройте нужный объект (Контакты, Компании, Сделки или пользовательский).
2. Нажмите кнопку Импорт на панели инструментов.
3. Перетащите или выберите CSV-файл. Первая строка должна содержать заголовки столбцов — всё в строке 1 считается названиями полей.
4. Появится экран сопоставления. Для каждого столбца CSV выберите соответствующее поле CRM из выпадающего списка или оставьте «Пропустить». Если заголовки совпадают — сопоставление автоматическое.
5. Нажмите Импорт. До 1 000 строк за раз. Пустые строки пропускаются автоматически.

После импорта вы увидите сводку: сколько записей создано и список строк с ошибками (с номерами). Исправьте ошибки в CSV и реимпортируйте эти строки. Руководство по миграции из таблиц: Из таблицы в CRM.

Экспорт в CSV

Нажмите кнопку Экспорт на странице любого объекта, чтобы скачать все записи в CSV. Экспорт включает каждый атрибут как столбец с правильным форматированием. Активные фильтры применяются перед экспортом — можно экспортировать отфильтрованную выборку.

Каждый объект поддерживает два режима просмотра (переключатель вверху страницы):

• Таблица: табличный вид в стиле электронной таблицы. Нажмите на заголовок столбца для сортировки. Измените ширину столбцов перетаскиванием. Редактируйте ячейки прямо кликом.
• Доска: Kanban-доска, сгруппированная по атрибуту статуса. Перетаскивайте карточки между столбцами для изменения статуса. Доступна для объектов с хотя бы одним полем статуса.

Фильтрация

Нажмите кнопку Фильтр для создания условий. Фильтры учитывают тип атрибута: числовое поле предлагает «больше» и «меньше», текстовое — «содержит» и «начинается с», дата — «до» и «после», а поле выбора позволяет выбрать из вариантов.

Можно комбинировать несколько фильтров связкой И или ИЛИ. Например: показать сделки на сумму более $10 000 И на стадии Переговоры, или контакты из Москвы ИЛИ Петербурга.

Сортировка

Нажмите на заголовок столбца в табличном виде для сортировки по возрастанию или убыванию. Нажмите снова для смены направления. Можно сортировать по любому полю: имя, дата, число, порядок статуса или любой пользовательский атрибут.

Нажмите Ctrl+K (или Cmd+K на Mac) в любом месте приложения, чтобы открыть командную палитру. Введите имя, email, название компании или любой текст для поиска по всем типам записей и спискам одновременно.

Результаты группируются по типу (Контакты, Компании, Сделки и пользовательские объекты) и включают совпадения из списков. Нажмите на результат, чтобы перейти к записи. Палитра также позволяет переходить на любую страницу по названию.

Для полноэкранного поиска откройте страницу Поиск из боковой панели. Работает так же, но даёт больше места для просмотра результатов и контекста.

Помимо Контактов, Компаний и Сделок можно создавать свои типы объектов для учёта чего угодно: проекты, товары, подрядчики, тикеты, объекты недвижимости, кампании и т.д.

Создание пользовательского объекта

1. Перейдите в Настройки > Объекты.
2. Нажмите + Новый объект.
3. Введите название в единственном числе (например, «Товар») и во множественном (например, «Товары»). Выберите иконку.
4. Добавьте атрибуты — поля вашего объекта. Для каждого выберите тип из 17 вариантов, задайте название и настройте: обязательное, уникальное, множественные значения.
5. Нажмите Создать. Объект сразу появится в боковой панели.

Пользовательские объекты поддерживают всё то же, что и встроенные: таблица и доска, фильтрация, сортировка, импорт/экспорт CSV, заметки, задачи, связанные записи и AI-чат.

Добавление атрибутов к существующим объектам

Пользовательские атрибуты можно добавить к любому объекту, включая встроенные. Перейдите в Настройки > Объекты, раскройте нужный объект и нажмите + Добавить атрибут. Новые атрибуты появятся как дополнительные столбцы в таблице и поля на карточке записи.

Доступ к настройкам — ссылка Настройки внизу боковой панели. Настройки разделены на секции:

Общие

Просмотр и редактирование названия пространства. Slug и внутренний ID показаны для справки (только чтение). Менять настройки пространства могут только админы.

Участники

Приглашение участников по email. Каждый имеет одну из двух ролей:

• Админ: полный доступ включая настройки, управление участниками, создание и отзыв API-ключей, настройку AI.
• Участник: полный доступ ко всем данным CRM (контакты, компании, сделки, задачи, заметки, списки, AI-чат), но не может менять настройки или управлять участниками.

Роль участника можно изменить или удалить его в любое время. Удаление участника немедленно отзывает доступ.

API-ключи

Создание Bearer-токенов для программного доступа из внешних инструментов, скриптов или автоматизаций. Ключи начинаются с oc_sk_ и показываются только один раз при создании — сразу скопируйте и сохраните в надёжном месте. Любой ключ можно отозвать в любое время — доступ прекращается мгновенно.

Для использования ключа добавляйте его в заголовок Authorization: Bearer oc_sk_... каждого API-запроса.

Настройка AI

Введите ключ OpenRouter и выберите модель AI по умолчанию для пространства. Доступные модели: Claude Sonnet 4, Claude Opus 4, GPT-4o, GPT-4o Mini, Llama 3.1 405B, Llama 3.1 70B и Gemini 2.0 Flash. Каждое пространство хранит свой ключ и выбор модели. Кнопка Проверить подключение отправляет тестовый запрос для проверки ключа и модели.

Здесь же настраивается AI-агент OpenClaw — встроенный ассистент, выполняющий действия в CRM от имени команды. Подробности в разделе AI-чат.

Объекты

Просмотр и управление всеми типами объектов и их атрибутами. Добавление пользовательских атрибутов к существующим объектам, создание новых типов, настройка вариантов статуса и цветов, установка ограничений полей (обязательное, уникальное). Подробности в разделе Пользовательские объекты.

OpenClaw CRM имеет полноценный REST API для интеграции с другими инструментами, автоматизации процессов, синхронизации данных с внешними системами или создания приложений поверх данных CRM.

Быстрый старт

1. Перейдите в Настройки > API-ключи и создайте ключ.
2. Добавляйте ключ в каждый запрос как Bearer-токен: Authorization: Bearer oc_sk_...
3. Начните с GET /api/v1/objects для получения списка всех типов объектов и их slug-ов.
4. Используйте GET /api/v1/objects/people/records для контактов, /companies для компаний, /deals для сделок и т.д.

Основные эндпоинты

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

• Краткий справочник: /llms-api.txt — список эндпоинтов, удобен для LLM-агентов
• Полный справочник: /llms-full.txt — подробная документация запросов/ответов
• OpenAPI-спецификация: /openapi.json — машинночитаемая спецификация для кодогенерации и тулинга

OpenClaw CRM — проект с лицензией MIT, спроектированный для развёртывания на своей инфраструктуре. Требуется Node.js 20+, pnpm 9+ и PostgreSQL 16+. Docker рекомендуется для базы данных. О преимуществах самостоятельного хостинга: Почему важно хостить CRM самостоятельно при работе с AI-агентом.

Требования

• Node.js 20 или новее: nodejs.org
• pnpm 9 или новее: npm install -g pnpm
• PostgreSQL 16 или новее (или Docker)
• Git

Установка для разработки

1. Клонируйте репозиторий:
   git clone https://github.com/giorgosn/openclaw-crm.git
2. Установите зависимости:
   cd openclaw-crm && pnpm install
3. Скопируйте файл окружения:
   cp .env.example .env
4. Отредактируйте .env — укажите URL базы данных и секрет авторизации. Таблица переменных ниже.
5. Запустите PostgreSQL через Docker:
   sudo docker compose up db -d
6. Примените схему базы данных:
   pnpm db:push
7. Загрузите начальные данные (стандартные объекты и стадии воронки):
   pnpm db:seed
8. Запустите сервер разработки:
   pnpm dev

Откройте http://localhost:3001 в браузере и создайте первый аккаунт.

Переменные окружения

Продакшен-деплой с Docker

Для продакшена используйте Docker Compose — он включает PostgreSQL и Next.js приложение в оптимизированных контейнерах.

1. Сгенерируйте секрет авторизации:
   export BETTER_AUTH_SECRET=$(openssl rand -base64 32)
2. Укажите продакшен-переменные в .env. Убедитесь, что NEXT_PUBLIC_APP_URL — ваш реальный домен, а не localhost.
3. Соберите и запустите продакшен-стек:
   docker compose -f docker-compose.prod.yml up --build -d

Продакшен-сборка использует PostgreSQL 16 и Node.js контейнер с Next.js standalone. Для SSL поставьте обратный прокси (Nginx или Caddy) перед контейнером приложения.