ClawX/README.ru-RU.md

ClawX

Десктоп-интерфейс для AI-агентов OpenClaw

Почему ClawX • Быстрый старт • Архитектура • Разработка • Участие

English | 简体中文 | 日本語 | Русский

---

Обзор

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

Автоматизация рабочих процессов, управление AI-каналами или планирование интеллектуальных задач — ClawX предоставляет интерфейс для эффективного использования AI-агентов.

ClawX поставляется с предварительно настроенными провайдерами моделей, соответствующими лучшим практикам, и нативно поддерживает Windows и многоязычные настройки. Расширенные параметры можно настроить через Настройки → Дополнительно → Режим разработчика.

Для получения полной корпоративной версии, специализированной поддержки или индивидуального сопровождения внедрения под ваш бизнес-сценарий свяжитесь с нами по адресу public@valuecell.ai.

Скриншоты

Чат	Запланированные задачи
Навыки	Каналы
Модели	Настройки

Почему ClawX

Создание AI-агентов не должно требовать владения командной строкой. Философия ClawX проста: мощные технологии заслуживают интерфейса, который уважает ваше время. ClawX построен непосредственно на официальном ядре OpenClaw. Вместо отдельной установки среда выполнения встроена в приложение, что обеспечивает бесшовный опыт «всё включено». Мы поддерживаем тесное соответствие с upstream-проектом OpenClaw, чтобы вы всегда имели доступ к официальным новейшим возможностям, улучшениям стабильности и совместимости с экосистемой.

Проблема	Решение ClawX
Сложная настройка через CLI	Установка в один клик с мастером настройки
Конфигурационные файлы	Визуальные настройки с проверкой в реальном времени
Управление процессами	Автоматическое управление жизненным циклом Gateway
Обновления приложения	Проверка обновлений при запуске с запросом перед скачиванием или установкой
Несколько AI-провайдеров	Единая панель настройки провайдеров
Установка навыков/плагинов	Локальное управление навыками с опциональным маркетплейсом от расширения

Возможности

• 🎯 Нулевой порог настройки: Весь процесс выполняется через интуитивный графический интерфейс — без терминальных команд, YAML-файлов и поиска переменных окружения.
• 💬 Интеллектуальный интерфейс чата: Несколько контекстов и история разговоров, потоковый Markdown с подсветкой синтаксиса, разбором CJK, таблицами и формулами KaTeX, прямая маршрутизация через @agent, встроенные карточки /skill, рабочие пространства с приоритетом и предпросмотр только для чтения Markdown, .docx, .pptx и локального HTML.
• 📡 Управление несколькими каналами: Настраивайте и отслеживайте независимые AI-каналы с несколькими аккаунтами, привязкой агента к аккаунту, переключением аккаунта по умолчанию и встроенным официальным плагином личного WeChat от Tencent.
• ⏰ Автоматизация по расписанию: Создавайте повторяющиеся или одноразовые расписания, вставляйте навыки в запланированные запросы и доставляйте результаты во внешние каналы.
• 🧩 Расширяемая система навыков: Управляйте навыками локально без зависимости от Gateway, обнаруживайте навыки из нескольких источников OpenClaw и используйте встроенные навыки обработки документов для pdf, xlsx, docx и pptx.
• 🔐 Безопасная интеграция провайдеров: Подключайте OpenAI, Anthropic, Z.AI / GLM и другие провайдеры; учётные данные хранятся в нативном системном хранилище ключей. Поддерживаются OAuth, пользовательские провайдеры, эндпоинты генерации изображений и совместимые резервные проверки.
• 🌙 Адаптивные темы: Выбирайте светлую, тёмную или синхронизированную с системой тему.
• 🚀 Управление автозапуском: Включите Запускать при старте системы в разделе Настройки → Общие.
• 🔔 Уведомления об обновлениях: Проверяйте новые версии при запуске и сами решайте, скачивать или устанавливать обновление.

Полное описание возможностей доступно в docs/ru-RU/features.md.

Типичные сценарии использования

• 🤖 Персональный AI-ассистент: Настройте универсального AI-агента для ответов на вопросы, составления писем, резюмирования документов и помощи с повседневными задачами через чистый десктопный интерфейс.
• 📊 Автоматизированный мониторинг: Планируйте агентов для отслеживания новостных лент, цен или определённых событий и доставляйте результаты в предпочитаемый канал уведомлений.
• 💻 Производительность разработчика: Интегрируйте AI в рабочий процесс разработки для проверки кода, генерации документации и автоматизации повторяющихся задач.
• 🔄 Автоматизация рабочих процессов: Объединяйте несколько навыков в визуальные конвейеры, которые обрабатывают данные, преобразуют контент и запускают действия.

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

Системные требования

• Операционная система: macOS 11+, Windows 10+ или Linux (Ubuntu 20.04+)
• Память: минимум 4 ГБ RAM (рекомендуется 8 ГБ)
• Хранилище: 1 ГБ свободного места на диске

Установка

Готовые релизы (рекомендуется)

Скачайте последний релиз для вашей платформы со страницы Releases.

Сборка из исходников

# Клонирование репозитория
git clone https://github.com/ValueCell-ai/ClawX.git
cd ClawX

# Инициализация проекта
pnpm run init

# Запуск в режиме разработки
pnpm dev

Первый запуск

При первом запуске ClawX Мастер настройки проведёт вас через следующие шаги:

1. Язык и регион — настройка предпочитаемой локали
2. AI-провайдер — добавление провайдеров с API-ключами или OAuth для провайдеров, поддерживающих вход через браузер или устройство
3. Пакеты навыков — выбор предустановленных навыков для распространённых сценариев
4. Проверка — тестирование конфигурации перед входом в основной интерфейс

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

Примечание о веб-поиске: ClawX отключает универсальный инструмент OpenClaw web_search на уровнях политик агента и Gateway. Это также относится к поиску Moonshot (Kimi); управляемая автоматизация браузера и web_fetch остаются доступными.

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

ClawX включает встроенные настройки прокси для Electron, OpenClaw Gateway и таких каналов, как Telegram, которым требуется доступ в интернет через локальный прокси-клиент.

Откройте Настройки → Gateway → Прокси, чтобы настроить прокси по умолчанию, правила обхода и дополнительные переопределения HTTP, HTTPS и ALL_PROXY / SOCKS в режиме разработчика. Пример локального адреса: http://127.0.0.1:7890.

Подробности о резервном поведении прокси, синхронизации с Telegram и OpenClaw Doctor см. в docs/ru-RU/proxy-settings.md.

Архитектура

ClawX использует двухпроцессную архитектуру с унифицированным уровнем Host API: React Renderer обращается к единой абстракции клиента, а Electron Main управляет выбором протокола, жизненным циклом Gateway и stdio bridge для ACP Chat.

• Модель процессов: Electron Main управляет окном, наблюдением за Gateway, системной интеграцией и обновлениями; OpenClaw Gateway предоставляет возможности AI-оркестрации, каналов и навыков; Renderer не обращается к локальным эндпоинтам напрямую.
• Доставка конфигурации: изменения среды выполнения используют авторитетный снимок config.set, поэтому обычные изменения провайдера, агента, навыка и модели не заменяют процесс Gateway; учётные данные обновляются без перезапуска через secrets.reload.
• ACP Chat: Chat использует ACP (Agent Client Protocol) через stdio bridge под управлением Main, поддерживая аутентифицированное воспроизведение истории после перезагрузки конфигурации, потоковую выдачу при навигации и медиа, вложения и файловые операции, проверенные Main.
• Принципы проектирования: единая точка входа фронтенда, транспорт под управлением Main, корректное восстановление с переподключением/таймаутом/повтором, безопасное хранение и границы, защищённые от CORS.

Схема процессов, координация конфигурации, семантика файловых операций ACP и устранение неполадок Gateway описаны в docs/ru-RU/architecture.md.

Разработка

Требования

• Node.js: 22.22.3+, 24.15.0+ или 25.9.0+ в пределах соответствующей основной версии (рекомендуется Node 24 LTS)
• Менеджер пакетов: pnpm 9+ (npm также поддерживается)
• Linux (Ubuntu/Debian): перед запуском Electron установите необходимые системные библиотеки; см. docs/ru-RU/development.md

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

pnpm run init        # Установить зависимости и скачать встроенные среды выполнения
pnpm dev             # Запустить режим разработки с горячей перезагрузкой
pnpm lint            # Запустить ESLint
pnpm typecheck       # Проверить типы TypeScript
pnpm test            # Запустить модульные тесты
pnpm run test:e2e    # Запустить дымовые E2E-тесты Electron
pnpm build           # Выполнить полную production-сборку
pnpm package         # Упаковать для текущей платформы (:mac / :win / :linux)

Структура проекта, полный список команд, политика параллельности E2E, диагностика производительности, проверки регрессий коммуникаций и технологический стек описаны в docs/ru-RU/development.md.

Участие

Мы приветствуем вклад сообщества! Исправления ошибок, новые функции, улучшения документации и переводы помогают сделать ClawX лучше.

Как внести вклад

1. Сделайте форк репозитория
2. Создайте ветку функции (git checkout -b feature/amazing-feature)
3. Зафиксируйте изменения с понятными сообщениями
4. Отправьте изменения в свою ветку
5. Откройте Pull Request

Руководящие принципы

• Следуйте существующему стилю кода (ESLint + Prettier)
• Пишите тесты для нового функционала
• Обновляйте документацию по мере необходимости
• Держите коммиты атомарными и описательными

Благодарности

ClawX построен на основе следующих отличных проектов с открытым исходным кодом:

• OpenClaw - Среда выполнения AI-агентов
• Electron - Кроссплатформенный десктоп-фреймворк
• React - Библиотека UI-компонентов
• shadcn/ui - Красиво спроектированные компоненты
• Zustand - Лёгкое управление состоянием

Сообщество

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

WeChat Enterprise	Группа Feishu	Discord

Партнёрская программа ClawX

Мы запускаем Партнёрскую программу ClawX и ищем партнёров, которые помогут представить ClawX большему числу клиентов, особенно клиентам с потребностями в кастомных AI-агентах или автоматизации.

Партнёры помогают связывать нас с потенциальными пользователями и проектами, а команда ClawX предоставляет полную техническую поддержку, кастомизацию и интеграцию. Если вы работаете с клиентами, заинтересованными в AI-инструментах или автоматизации, мы будем рады сотрудничеству.

Напишите нам в DM или на public@valuecell.ai, чтобы узнать больше.

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

Лицензия

ClawX выпускается под лицензией MIT. Вы можете свободно использовать, изменять и распространять это программное обеспечение.

---

_{Создано с ❤️ командой ValueCell}