Учебник по OpenClaw (Clawdbot)
OpenClaw (ранее Clawdbot, переходное название Moltbot) — это проект персонального AI-ассистента с открытым исходным кодом, который внезапно стал вирусным в январе 2026 года, разработанный Питером Штайнбергером (основателем PSPDFKit).
OpenClaw — это агент, который может выполнять задачи. Когда мы даём инструкции, он не только отвечает, но и проактивно управляет системой, посещает веб-страницы, обрабатывает электронные письма, организует файлы, устанавливает напоминания и даже автоматически пишет код.
OpenClaw — этолокальная вычислительная мощность + автоматизация агентов с большой модельюдоведённый до предела инструмент продуктивности разработчика.
Цель OpenClaw — сделать так, чтобы AI не просто давал советы, а напрямую выполнял полные инженерные задачи.

Поскольку Anthropic 27 января направила письмо от юриста с утверждением, что Clawd / Clawdbot слишком похожи на Claude, проект в тот же день срочно переименовали в Moltbot (означает линяющего лобстера, талисман — маленький лобстер Molty 🦞), но функциональность остаётся точно такой же, и старая команда clawdbot по-прежнему совместима.
Moltbot — переходное название, придуманное командой проекта для устранения рисков нарушения прав; OpenClaw — текущее окончательное официальное название.
-
Официальный сайт OpenClaw:https://openclaw.ai/
Документация на китайском:https://docs.openclaw.ai/zh-CN
-
Адрес GitHub:https://github.com/openclaw/openclaw
Коллекция навыков OpenClaw:https://github.com/VoltAgent/awesome-openclaw-skills
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
Установка с помощью легкого сервера 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 |
|---|---|---|---|
| Планирование задач | Сильная | Средняя | Средняя |
| Автоматическое выполнение | Комплексность | Частичная | Частичная |
| Самовосстановление | Да | Отсутствует | Отсутствует |
| Операции инженерного уровня | Сильная | Сильная | Средняя |
| Локальная автоматизация | Нативная поддержка | Относительно слабый | Относительно слабый |
