переведено ИИ

🦞 OpenClaw — Персональный AI-ассистент

<picture>
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/openclaw/openclaw/main/docs/assets/openclaw-banner-light.png">

OpenClaw — это персональный AI-ассистент, который учится и растет вместе с вами, работая на ваших собственных устройствах — разрабатываемый открыто фондом OpenClaw Foundation (некоммерческая организация). Он отвечает вам на тех каналах, которые вы уже используете. Он может говорить и слушать на macOS/iOS/Android, а также отображать интерактивный Canvas, которым вы управляете. Шлюз (Gateway) — это просто панель управления, а продуктом является сам ассистент.

Если вы ищете персонального, однопользовательского ассистента, который ощущается локальным, быстрым и всегда доступным, то это он.

Поддерживаемые каналы включают: WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WeChat, QQ, WebChat.

Сайт · Документация · Видение · Уведомления сторонних производителей · DeepWiki · Начало работы · Обновление · Примеры · ЧаВо · Вводная настройка · Nix · Docker · Discord

Новая установка? Начните здесь: Начало работы

Рекомендуемая настройка: запустите openclaw onboard в вашем терминале. OpenClaw Onboard проведет вас пошагово через настройку шлюза, рабочего пространства, каналов и навыков. Это рекомендуемый путь настройки через CLI и работает на macOS, Linux и Windows. Пользователи Windows десктопа могут начать с нативного приложения Windows Hub для настройки, индикатора в области уведомлений, чата, режима узла и локального режима MCP. Работает с npm, pnpm или bun.

Спонсоры

Подписки (OAuth):

OpenAI (ChatGPT/Codex)

Примечание о моделях: хотя поддерживаются многие провайдеры и модели, предпочтение стоит отдавать текущей флагманской модели от провайдера, которому вы доверяете и которого уже используете. Смотрите Вводная настройка.

Установка (рекомендуемая)

Среда выполнения: Node 24.15+ (рекомендуется), Node 22.22.3+ или Node 25.9+.

npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest

openclaw onboard --install-daemon

OpenClaw Onboard устанавливает демон шлюза (launchd/systemd пользовательский сервис), чтобы он продолжал работать.

Быстрый старт (кратко)

Среда выполнения: Node 24.15+ (рекомендуется), Node 22.22.3+ или Node 25.9+.

Полное руководство для новичков (аутентификация, сопряжение, каналы): Начало работы

Рекомендуемый режим демона:

openclaw onboard --install-daemon
openclaw gateway status

Режим foreground/отладки:

openclaw gateway stop
openclaw gateway --port 18789 --verbose

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

# Send a message
openclaw message send --target +1234567890 --message "Hello from OpenClaw"

# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/IRC/Microsoft Teams/Matrix/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WeChat/QQ/WebChat)
openclaw agent --message "Ship checklist" --thinking high

Обновление? Руководство по обновлению (а также запустите openclaw doctor).

Конфигурация моделей + CLI: Модели. Ротация профилей аутентификации + резервные варианты: Резервное переключение моделей.

Настройки безопасности (Доступ к личным сообщениям)

OpenClaw подключается к реальным поверхностям обмена сообщениями. Обрабатывайте входящие личные сообщения (ЛС) как недоверенный ввод.

Полное руководство по безопасности: Безопасность. Перед публичным доступом в интернет используйте Руководство по развертыванию шлюза.

Поведение по умолчанию в Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack:

Сопряжение через ЛС (dmPolicy="pairing" / channels.discord.dmPolicy="pairing" / channels.slack.dmPolicy="pairing"; устаревшие варианты: channels.discord.dm.policy, channels.slack.dm.policy): неизвестные отправители получают короткий код сопряжения, и бот не обрабатывает их сообщение.
Одобрение: openclaw pairing approve <channel> <code> (после чего отправитель добавляется в локальное хранилище разрешенных лиц).
Публичные входящие ЛС требуют явного подключения: установите dmPolicy="open" и включите "*" в список разрешенных каналов (allowFrom / channels.discord.allowFrom / channels.slack.allowFrom; устаревшие варианты: channels.discord.dm.allowFrom, channels.slack.dm.allowFrom).

Запустите openclaw doctor для выявления рискованных/неправильно настроенных политик ЛС.

Основные возможности

Локальный шлюз (Gateway) — единая панель управления для сессий, каналов, инструментов и событий.
Многоканальный входящий ящик — WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WeChat, QQ, WebChat, macOS, iOS/Android.
Маршрутизация с несколькими агентами — маршрутизация входящих каналов/аккаунтов/пиров к изолированным агентам (рабочие пространства + сессии для каждого агента).
Голосовое пробуждение + Режим разговора — активационные слова на macOS/iOS и непрерывный голосовой ввод на Android (ElevenLabs + системное TTS с запасным вариантом).
Живой холст — управляемая агентом визуальная рабочая область с A2UI.
Инструменты первого класса — браузер, холст, узлы, cron, сессии и действия для Discord/Slack.
Приложения-компаньоны — Windows Hub, приложение для панели меню macOS и узлы для iOS/Android.
Знакомство + навыки — настраиваемое через мастер знакомства с встроенными/управляемыми/рабочими навыками.

Модель безопасности (важно)

По умолчанию: инструменты работают на хосте для сессии main, поэтому агент имеет полный доступ, когда это только вы.
Безопасность в группах/каналах: установите agents.defaults.sandbox.mode: "non-main", чтобы запускать не-main сессии внутри песочниц. Docker — бэкенд песочницы по умолчанию; также доступны SSH и OpenShell.
Типичные настройки песочницы по умолчанию: разрешено bash, process, read, write, edit, sessions_list, sessions_history, sessions_send, sessions_spawn; запрещено browser, canvas, nodes, cron, discord, gateway.
Прежде чем что-либо открывать удаленно, прочитайте Безопасность, Руководство по раскрытию шлюза, Песочницы и Конфигурация.

Быстрые справочники оператора

Команды чата: /status, /new, /reset, /compact, /think <level>, /verbose on|off, /trace on|off, /usage off|tokens|full, /restart, /activation mention|always
Инструменты сессий: sessions_list, sessions_history, sessions_send
Реестр навыков: ClawHub
Обзор архитектуры: Архитектура

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

Новичок: Начало работы, Знакомство, Обновление
Настройка каналов: Индекс каналов, WhatsApp, Telegram, Discord, Slack
Приложения + узлы: Windows Hub, macOS, iOS, Android, Узлы
Конфигурация + безопасность: Конфигурация, Безопасность, Руководство по раскрытию, Песочницы
Удаленный доступ + веб: Шлюз, Удаленный доступ, Tailscale, Веб-интерфейсы
Инструменты + автоматизация: Инструменты, Навыки, Задачи cron, Вебхуки, Gmail Pub/Sub
Внутренности: Архитектура, Агент, Модель сессий, Протокол шлюза
Устранение неполадок: Устранение проблем каналов, Логирование, Документация

Приложения (необязательно)

Один только Шлюз обеспечивает отличный опыт. Все приложения необязательны и добавляют дополнительные функции.

Если вы планируете создавать/запускать приложения-компаньоны, следуйте приведенным ниже руководствам по платформам.

macOS (OpenClaw.app) (необязательно)

Управление шлюзом и состоянием здоровья через панель меню.
Голосовое пробуждение + оверлей «нажми и говори».
WebChat + инструменты отладки.
Удаленное управление шлюзом через SSH.

Примечание: подписанные сборки необходимы для сохранения разрешений macOS между пересборками (см. Разрешения macOS).

Узел iOS (необязательно)

Сопрягается как узел через WebSocket шлюза (сопряжение устройств).
Перенаправление голосового триггера + интерфейс холста.
Управляется через openclaw nodes ….

Руководство: Подключение iOS.

Узел Android (необязательно)

Сопрягается как WS-узел через сопряжение устройств (openclaw devices ...).
Предоставляет вкладки Connect/Chat/Voice плюс Canvas, Camera, Screen capture и семейства команд Android.
Руководство: Подключение Android.

Из исходного кода (разработка)

Для проверки исходного кода используйте pnpm. Репозиторий представляет собой рабочее пространство pnpm, и встроенные плагины загружаются из extensions/* во время разработки, поэтому их локальные зависимости пакета и ваши правки используются напрямую. Обычный npm install в корне репозитория не является поддерживаемой конфигурацией исходного кода.

Для цикла разработки:

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

pnpm install

# First run only (or after resetting local OpenClaw config/workspace)
pnpm openclaw setup

# Optional: prebuild Control UI before first startup
pnpm ui:build

# Dev loop (auto-reload on source/config changes)
pnpm gateway:watch

Если вам нужна собранная папка dist/ из проверки (для Node, упаковки или проверки выпуска), выполните:

pnpm build
pnpm ui:build

pnpm openclaw setup записывает локальную конфигурацию/рабочее пространство, необходимые для pnpm gateway:watch. Его безопасно перезапускать, но обычно это нужно только при первой настройке или после сброса локального состояния. pnpm gateway:watch передает настроенный порт шлюза от установленного сервиса в持久ую панель tmux; запускайте pnpm openclaw gateway start, когда вам снова нужен установленный сервис. Он не пересобирает dist/control-ui, поэтому перезапускайте pnpm ui:build после изменений в ui/ или используйте pnpm ui:dev при итеративной разработке Control UI. Если вы хотите, чтобы эта проверка запускала знакомство напрямую, используйте pnpm openclaw onboard --install-daemon.

Примечание: pnpm openclaw ... запускает TypeScript напрямую (через tsx). pnpm build создает dist/ для запуска через Node / упакованный бинарный файл openclaw, в то время как pnpm gateway:watch пересобирает среду выполнения по требованию во время цикла разработки.

Каналы разработки

stable: помеченные релизы (vYYYY.M.D или vYYYY.M.D-<patch>), npm dist-tag latest.
beta: предрелизные теги (vYYYY.M.D-beta.N), npm dist-tag beta (macOS приложение может отсутствовать).
dev: подвижная верхушка main, npm dist-tag dev (при публикации).

Переключение каналов (git + npm): openclaw update --channel stable|beta|dev. Подробности: Каналы разработки.

Рабочее пространство агента + навыки

Корень рабочего пространства: ~/.openclaw/workspace (настраивается через agents.defaults.workspace).
Инжектируемые файлы подсказок: AGENTS.md, SOUL.md, TOOLS.md.
Навыки: ~/.openclaw/workspace/skills/<навык>/SKILL.md.

Конфигурация

Минимальный ~/.openclaw/openclaw.json (модель + настройки по умолчанию):

{
  agent: {
    model: "<provider>/<model-id>",
  },
}

Полная справка по конфигурации (все ключи + примеры).

История звёзд

Molty

OpenClaw был создан для Molty, космического лобстерного AI-ассистента. 🦞 От Питера Штайнбергера и сообщества.

Сообщество

Смотрите CONTRIBUTING.md для руководств, мейнтейнеров и информации о том, как отправлять PR. Используйте выбор проблемы для багов, ошибок в документации и запросов функций; задавайте вопросы по настройке/поддержке в Discord; и сообщайте об уязвимостях через SECURITY.md. PR должны, по возможности, ссылаться на соответствующую проблему и следовать шаблону PR с указанием проблемы, воздействия и доказательств. Приветствуются PR, написанные с помощью AI/vibe-coding! 🤖

Особая благодарность Mario Zechner за его поддержку и за pi-mono. Особая благодарность Adam Doppelt за домен lobster.bot.

Спасибо всем клавтрибьюторам (clawtributors):