Учебник по OpenClaw (Clawdbot)

OpenClaw (ранее Clawdbot, переходное название Moltbot) — это проект персонального AI-ассистента с открытым исходным кодом, который внезапно стал вирусным в январе 2026 года, разработанный Питером Штайнбергером (основателем PSPDFKit).

OpenClaw — это агент, который может выполнять задачи. Когда мы даём инструкции, он не только отвечает, но и проактивно управляет системой, посещает веб-страницы, обрабатывает электронные письма, организует файлы, устанавливает напоминания и даже автоматически пишет код.

OpenClaw — этолокальная вычислительная мощность + автоматизация агентов с большой модельюдоведённый до предела инструмент продуктивности разработчика.

Цель OpenClaw — сделать так, чтобы AI не просто давал советы, а напрямую выполнял полные инженерные задачи.

Поскольку Anthropic 27 января направила письмо от юриста с утверждением, что Clawd / Clawdbot слишком похожи на Claude, проект в тот же день срочно переименовали в Moltbot (означает линяющего лобстера, талисман — маленький лобстер Molty 🦞), но функциональность остаётся точно такой же, и старая команда clawdbot по-прежнему совместима.

Moltbot — переходное название, придуманное командой проекта для устранения рисков нарушения прав; OpenClaw — текущее окончательное официальное название.

Clawbot, Moltbot и OpenClaw — на самом деле один и тот же проект с открытым исходным кодом. Последовательность эволюции названий такова:

Clawdbot → Moltbot → OpenClaw
Name Хронология Предыстория/причина Основная взаимосвязь
Clawdbot / Clawbot Конец 2025 — начало января 2026 Первоначальное название проекта; вдохновленоClaudeиclawмемом (клешня лобстера) Исходное название; самая ранняя идентичность на GitHub
Moltbot 27 января 2026 Потребовалось переименование из-за опасений по поводу товарного знака Anthropic Промежуточное переходное название; функциональность и код идентичны Clawdbot
OpenClaw После 30 января 2026 Устранены конфликты по авторским правам, сделан акцент на открытости исходного кода и долгосрочном брендинге Текущее официальное название; также единый идентификатор для будущей документации, репозиториев и т. д.

Способы установки

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

Системные требования (не обязательно Mac mini):

  • Аппаратное обеспечение: очень низкое; 2GB RAM достаточно для запуска.
  • Среда: поддерживаются Mac, Windows, Linux; требуется Node.js (pnpm) или Docker.

1. Рекомендуемая установка (скрипт в один клик):

Выполните следующую команду прямо в терминале.

Системы macOS/Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

Системы Windows:

#PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Это автоматически установит Node.js (≥22) и выполнит базовую настройку.

2. Ручная установка

Вам требуетсяNode.js ≥22и необходимо выполнить базовую настройку:

Использование npm:

npm i -g openclaw

# 如果速度慢可以指定国内镜像
npm i -g openclaw --registry=https://registry.npmmirror.com

Или с использованием pnpm:

pnpm add -g openclaw

После установки инициализируйте и установите фоновую службу (пользовательскую службу launchd / systemd):

openclaw onboard

3. Установка из исходного кода (режим разработки)

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install

pnpm ui:build   # 首次运行会自动安装 UI 相关依赖并构建前端界面
pnpm build      # 构建整个项目(包含后端与相关模块)

# 初始化 OpenClaw 并安装为系统后台服务(开机自动运行)
pnpm openclaw onboard --install-daemon

# 开发模式:监听 TypeScript 代码变更并自动重载网关服务
pnpm gateway:watch


Руководство по конфигурации

Рекомендуем устанавливать с помощью скрипта в один клик.

Системы macOS/Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

Системы Windows:

#PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

Чтобы позже снова войти в мастер настройки, выполните следующую команду:

openclaw onboard --install-daemon

Затем он напомнит, что этот лобстер очень мощный, и, конечно, риск тоже высок. Мы выбираемyes(no означает, что он не будет установлен), и всё:

Далее мы выбираем Quick StartQuickStart(опция):

Далее нам нужно настроить большую модель. В поле Model/Auth Provider выберите поставщика ИИ; обычно поддерживаются как отечественные, так и зарубежные поставщики.

Если у вас нет зарубежного аккаунта, вы также можете настроить API-ключи от отечественных провайдеров, таких как Qwen, MiniMax и Zhipu. Файл конфигурации аутентификации (OAuth + API key) находится по пути~/.openclaw/agents/<agentId>/agent/auth-profiles.json, и вы сможете изменить его в этом файле позже.

Затем появится опция выбора чат-инструмента. Если у вас нет зарубежных, можете выбрать последний:

Другие конфигурации, например настройки портаGateway Port, просто оставьте по умолчанию 18789. Например, для Skills и менеджера пакетов выберите npm или другие; можно просто всё время нажимать Yes.

Выберите несколько навыков, которые вам нравятся, или можете сразу пропустить, и используйте клавишуspaceдля выбора:

Для этих API-ключей, если у вас их нет, просто выберитеno:

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

Выберите Open the Web UI, чтобы открыть его в браузере:

После установки он автоматически перейдёт по адресуhttp://127.0.0.1:18789/chat, и вы сможете открыть интерфейс чата, чтобы он начал работать.

Например, поищите последние новости технологий:

После запуска мы можем использовать командуopenclaw status, чтобы проверить статус:

openclaw status

Если вы установили службу во время первичной настройки, Gateway уже должен быть запущен:

openclaw gateway status

Ручной запуск (в foreground):

openclaw gateway --port 18789 --verbose

Команды, которые можно выполнить после установки:

  • Запустить онбординг:openclaw onboard --install-daemon
  • Быстрая проверка:openclaw doctor
  • Проверить состояние работоспособности Gateway:openclaw status + openclaw health
  • Открыть панель управления:openclaw dashboard

Удаление

Используйте встроенное средство удаления:

openclaw uninstall

Неинтерактивный режим (автоматизация / npx):

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

Использование навыков

Навыки — это отдельные папки, содержащие файл SKILL.md. Если вы хотите добавить новые возможности агенту OpenClaw, ClawHub — лучший выбор для поиска и установки навыков.

Адрес репозитория навыков ClawHub:https://clawhub.ai/

Китайское зеркало ClawHub:https://skillhub.tencent.com/

Установить инструмент ClawHub:

# 推荐方式(npx 无需全局安装)
npx clawhub@latest --version

# 或全局安装(方便以后直接用 clawhub 命令)
npm install -g clawhub
# 或者用 pnpm
pnpm add -g clawhub

Войти:

clawhub login

Поиск навыков:

clawhub search "postgres backups"

Скачать и установить новые навыки:

clawhub install my-skill-pack

Пакетное обновление установленных навыков:

clawhub update --all

Управление плагинами

Плагины — это легковесные программные модули, которые могут расширять дополнительную функциональность OpenClaw, добавляя команды, инструменты и возможности RPC шлюза.

Просмотр загруженных плагинов:

openclaw plugins list

Установка официальных плагинов (например, плагина голосовых вызовов):

openclaw plugins install @openclaw/voice-call

Перезапустите шлюз после установки плагина, чтобы изменения вступили в силу:

openclaw gateway restart

Основные команды

Краткий справочник по общим командам OpenClaw:

Категория Команда Описание
Инициализация и установка openclaw onboard Интерактивный мастер (настройка модели, канала, шлюза, рабочего пространства)
Инициализация и установка openclaw setup Инициализировать конфигурацию + рабочее пространство (неинтерактивно)
Инициализация и установка openclaw configure Интерактивный мастер настройки (модель, канал, навыки)
Управление шлюзом openclaw gateway status Проверить состояние службы шлюза + проверка работоспособности RPC
Управление шлюзом openclaw gateway start Запустить службу шлюза
Управление шлюзом openclaw gateway stop Остановить службу шлюза
Управление шлюзом openclaw gateway restart Перезапустить службу шлюза
Управление шлюзом openclaw gateway run Запустить шлюз напрямую в переднем плане (для отладки)
Управление шлюзом openclaw gateway health Получить информацию о состоянии шлюза
Управление конфигурацией openclaw config file Показать полный путь текущего файла конфигурации
Управление конфигурацией openclaw config get <path> Прочитать элементы конфигурации
Управление конфигурацией openclaw config set <path> <value> Изменить элементы конфигурации
Управление конфигурацией openclaw config validate Проверить корректность файла конфигурации
Диагностика и статус openclaw doctor Проверка работоспособности в один клик + автоматическое восстановление
Диагностика и статус openclaw status Показать состояние работоспособности сеанса и недавние контакты
Диагностика и статус openclaw health Получить данные о работоспособности от работающего шлюза
Диагностика и статус openclaw logs Просмотр логов шлюза в реальном времени
Другие часто используемые операции openclaw dashboard Открыть веб-панель управления
Другие часто используемые операции openclaw channels status Просмотр подключённых каналов чата
Другие часто используемые операции openclaw agent run Вручную запустить прокси

После изменения конфигурации не забудьте запуститьopenclaw gateway restartЧтобы изменения вступили в силу ~ 🦞

Управление каналами

  • WhatsApp:openclaw channels login(или отсканируйте QR-код)
  • Telegram:openclaw channels add --channel telegram(требуется Bot Token)
  • Discord:openclaw channels add --channel discord(требуется Bot Token)
  • iMessage: нативный мост macOS
  • Slack:openclaw channels add --channel slack(требуется Bot Token)

Структура рабочей области (Анатомия рабочей области)

  • AGENTS.md: описание инструкции
  • USER.md: настройки предпочтений
  • MEMORY.md: долговременная память
  • HEARTBEAT.md: контрольный список
  • SOUL.md: личность/тон
  • IDENTITY.md: имя/тема
  • BOOT.md: конфигурация запуска
  • Корневой каталог:~/.openclaw/workspace

Слэш-команды в чате

  • /status: Состояние + контекст
  • /context list: Источники контекста
  • /model <m>: Переключить модель
  • /compact: Освободить место в окне
  • /new: Новый диалог
  • /stop: Прервать текущий запуск
  • /tts on|off: Переключить голос
  • /think: Переключить режим рассуждений

Сопоставление ключевых путей (основная карта путей)

  • Основная конфигурация:~/.openclaw/openclaw.json
  • Рабочая область по умолчанию:~/.openclaw/workspace/
  • Каталог состояния агента:~/.openclaw/agents/<cid>/
  • OAuth и ключи API:~/.openclaw/agents/<agentId>/agent/auth-profiles.json, если используется старая версия~/.openclaw/credentials/
  • Хранилище векторного индекса:~/.openclaw/memory/<cid>.sqlite
  • Глобальные общие навыки:~/.openclaw/skills/
  • Файловые логи Gateway:/tmp/openclaw/*.log

Голос и TTS

  • Платно: OpenAI / ElevenLabs
  • Бесплатно: Edge TTS (API-ключ не требуется)
  • Автоматический TTS:messages.tts.auto: "always"

Память и модели

  • Векторный поиск:memory search "X"
  • Переключение моделей:models set <model>
  • Настройки аутентификации:models auth setup
  • Журналы:memory/YYYY-MM-DD.md

Хуки и навыки

  • ClawHub:clawhub install <slug>
  • Список хуков:openclaw hooks list

Устранение неполадок

  • Нет ответа на личное сообщение → Список пар → Подтвердить
  • Без звука в группе → Проверить конфигурацию шаблона упоминаний
  • Срок аутентификации истёк →models auth setup-token
  • Шлюз закрыт →doctor --deep
  • Ошибка памяти → Перестроить индекс памяти

Автоматизация и исследования

  • Браузер:browser start/screenshot
  • Субагенты:/subagents list/info
  • Запланированные задачи:cron list/run <cid>
  • Пульс:heartbeat.every: "30m"

Установка и настройка напрямую через стороннее облако

Все основные платформы теперь поддерживают этого агента. Если вы не хотите устанавливать его локально, вы можете развернуть OpenClaw в облаке в один клик:

Установка с помощью легкого сервера Alibaba Cloud:https://www.aliyun.com/activity/ecs/clawdbot。

Вы можете использовать их образы для установки в один клик:

Установка с помощью легкого сервера Tencent Cloud:https://cloud.tencent.com/developer/article/2624973


Основные команды

Основные команды OpenClaw приведены ниже:

================= Базовый статус / Диагностика ================= ================= Инициализация / Установка ================= ================= Конфигурация ================= ================= Управление каналами ================= ================= Логи ================= ================= Автоматизация / Исследования ================= ================= Удаление =================
Команда Назначение Примечания / Параметры
openclaw status Просмотр текущего статуса работы шлюза Включает информацию о состоянии и контексте
openclaw health Проверка состояния Обнаружение ядра, зависимостей и среды выполнения
openclaw doctor Комплексная диагностика и рекомендации по устранению неисправностей Поддержка--deepГлубокая проверка
openclaw onboard Интерактивный мастер инициализации Рекомендуется при первом использовании
openclaw onboard --install-daemon Установить системный демон Запустить Gateway в фоновом режиме как демон
openclaw onboard --uninstall-daemon Удалить демон Не удалять данные
openclaw configure Интерактивный мастер настройки Модели, каналы, учётные данные и т. д.
openclaw config get <path> Получить значение конфигурации JSON Path
openclaw config set <path> <value> Установить элемент конфигурации Поддерживает JSON5 / необработанный текст
openclaw config unset <path> Очистить элемент конфигурации Удалить одну пару ключ-значение
openclaw channels list Список каналов, в которые выполнен вход WhatsApp / Telegram / Discord и т. д.
openclaw channels login Войти в новый аккаунт канала Сканирование QR-кода или процесс авторизации
openclaw channels add Добавить канал Telegram / Discord / Slack
openclaw channels status --probe Проверка работоспособности канала Проверить доступность соединения
openclaw skills list Список навыков Установленные / доступные навыки
openclaw skills info <skill> Сведения о навыке Параметры, информация о версии
clawhub install <slug> Установить навык из ClawHub Официальный маркетплейс навыков
openclaw hooks list Список хуков Механизм событийных хуков
openclaw plugins list Список плагинов Просмотр установленных плагинов
openclaw plugins install <id> Установить плагин Например@openclaw/voice-call
openclaw plugins enable <id> Включить плагин Обычно требует перезапуска Gateway
openclaw models list Список доступных моделей Включает статус аутентификации
openclaw models status Статус модели Текущая доступность
openclaw models auth setup-token Конфигурация аутентификации модели Рекомендуемый подход из шпаргалки
openclaw memory search "X" Поиск в долговременной памяти Векторный поиск
openclaw memory index Перестроить индекс памяти Исправить аномалии памяти
openclaw logs Просмотреть логи Агрегированный вывод по умолчанию
openclaw logs --follow Логи в реальном времени --json / --plain / --limit
openclaw gateway install Установить системную службу Gateway Зарегистрировать как системный демон
openclaw gateway start Запустить службу Gateway Режим системной службы
openclaw gateway stop Остановить службу Gateway
openclaw gateway restart Перезапустить службу Gateway Использовать после изменения конфигурации
openclaw gateway status Состояние системной службы Gateway Отличается отopenclaw status
openclaw browser start Запустить агент браузера Возможности автоматизации
openclaw browser screenshot Скриншот веб-страницы
openclaw subagents list Список субагентов
openclaw cron list Список запланированных задач
openclaw cron run <id> Выполнить запланированные задачи
openclaw uninstall Удалить службу Gateway и данные Официальная рекомендация
openclaw uninstall --all --yes --non-interactive Полностью автоматическое удаление Статус / рабочая область / плагины
openclaw uninstall --state Удалить файлы состояния Не удалять рабочую область
openclaw uninstall --workspace Удалить рабочее пространство данные агента / рабочего пространства
openclaw uninstall --service Удалить только системную службу Не удалять данные
openclaw uninstall --dry-run Симулировать удаление Показать только результаты

Почему в последнее время это так популярно?

  • Он действительно достигает уровня «как JARVIS»: может читать/записывать файлы, выполнять команды терминала, управлять браузерами, отправлять/получать электронные письма, календарь, писать код, бронировать авиабилеты, очищать входящие...
  • Приоритет локальной работы + долговременная память: все разговоры используют общий контекст на всех платформах, а каталоги USER.md и memory/ становятся умнее по мере использования
  • Поддерживает почти все основные модели: Claude, Gemini, OpenAI, локальные модели Ollama, Pi и т. д.
  • Взрывной рост экосистемы навыков сообщества: ClawdHub уже насчитывает 500+ навыков сообщества (Slack, Discord, GitHub, управление браузером, автоматизация UI macOS...)
  • Установка так же проста, как npm install, но реальные возможности довольно пикантные (по словам разработчика)

Его основные возможности включают:

  • Разбивать цели на естественном языке на выполнимые шаги
  • Автоматически вызывать команды терминала
  • Создавать и изменять файлы проекта
  • Запускать код и проверять результаты
  • Автоматически исправлять на основе сообщений об ошибках

По сравнению с инструментами автодополнения кода, такими как Claude Code/OpenCode, OpenClaw ближе к инженерному агенту с правами на выполнение.

  • Claude Code и OpenCode сильны в качестве кода и его понимании
  • OpenClaw силён в автоматическом выполнении всего инженерного процесса
Аспект возможностей OpenClaw Claude Code OpenCode
Планирование задач Сильная Средняя Средняя
Автоматическое выполнение Комплексность Частичная Частичная
Самовосстановление Да Отсутствует Отсутствует
Операции инженерного уровня Сильная Сильная Средняя
Локальная автоматизация Нативная поддержка Относительно слабый Относительно слабый
Другие расширения