MCPcopy Index your code
hub / github.com/Leon-PanPan/dragonclaw

github.com/Leon-PanPan/dragonclaw @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
615 symbols 1,309 edges 58 files 21 documented · 3%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

DragonClaw

DragonClaw

Возможно, лучший на сегодня десктопный клиент для OpenClaw — на Electron, Vue 3 и Vite.

🌐 Официальный сайт: http://www.dragonclaw.cc

License: MIT Platform Framework Build Language

English · 简体中文 · 繁體中文 · 日本語 · Русский · 한국어 · العربية · Deutsch


📑 Содержание


🐉 О DragonClaw

DragonClaw — это целенаправленно разработанный десктопный клиент для OpenClaw, созданный поверх официального WebSocket API OpenClaw. Он построен на современном стеке Electron + Vue 3 + Arco Design и поставляется со всем необходимым окружением для работы OpenClaw — установил и сразу работает. Если OpenClaw уже установлен на вашей машине, DragonClaw обнаружит его и будет использовать автоматически — без затрат на миграцию.

DragonClaw — это не просто «графическая оболочка» для Gateway. Он привносит целый ряд инновационных, продуктовых возможностей:

  • 🧠 Управление агентами — список, создание, обновление и удаление агентов; чтение/запись файлов рабочей области каждого агента.
  • 🧩 Центр навыков — рекомендуемые навыки, поиск по всему каталогу, установка/удаление одним кликом.
  • 💬 Множественные диалоги — параллельные сессии с умной группировкой, закреплением, метками непрочитанного и полной историей.
  • 📁 Рабочие области уровня сессии — задание рабочей папки для текущей сессии прямо в окне диалога; все результаты работы OpenClaw остаются внутри этой области и не загрязняют остальное пространство.
  • 🌳 Подзадачи — визуализация подзадач и подагентских сессий, порождённых основным агентом, в реальном времени.
  • 📚 Конфигурация моделей — встроенная поддержка OpenAI, Anthropic, DeepSeek, Grok, OpenRouter, Groq, Moonshot, Alibaba, Ollama, ModelBus и пользовательских поставщиков.
  • 🏪 Agents Store — подбор подходящих агентов онлайн и установка вместе с необходимыми им навыками одним кликом.
  • 📋 Канбан — доска задач для организации работы между агентами.
  • 📜 Журналы — потоковый просмотр логов Gateway прямо из приложения.
  • ⚙️ Единые настройки — базовые, шлюз, агенты, сессии, инструменты и безопасность на одной панели.
  • 🔄 Обнаружение обновлений — автоматическая проверка обновлений DragonClaw, OpenClaw, Node.js и др. при запуске.
  • 🌐 Удалённый доступ — безопасное подключение к OpenClaw Gateway в локальной сети или на удалённом сервере по токену или паролю.

📖 Подробные описания функций (диалоги, рабочие области, подзадачи, конфигурация моделей, Agents Store, обнаружение обновлений, удалённый доступ) см. в разделе 🔍 Подробнее о функциях ниже.


🔍 Подробнее о функциях

Ниже — более детальный обзор ключевых возможностей DragonClaw и сценариев их применения.

💬 Диалоги (Conversation)

Панель диалогов — сердце DragonClaw. Это не простое окно чата, а полноценная система совместной работы с множеством сессий:

  • Параллельные сессии — открывайте несколько диалогов одновременно, привязывая их к разным агентам или задачам. Переключение из боковой панели без перекрёстных помех.
  • Умная группировка — исторические сессии автоматически организуются в группы Сегодня, Вчера, На этой неделе, Ранее — чисто и предсказуемо.
  • Закрепление и непрочитанные — важные сессии можно закрепить; непрочитанные отмечаются красной точкой, чтобы ничто не потерялось.
  • Потоковый вывод — ответы модели поступают в реальном времени, с параллельным отображением хода рассуждений и результатов вызова инструментов.
  • Прокрутка истории — прокрутите к началу, чтобы лениво подгрузить более ранние сообщения; ничего не обрезается.
  • Действия с сообщениями — копирование, цитирование, удаление и «сжатие» сессии доступны локально.
  • Уровень рассуждения — выбирайте интенсивность мышления (высокий / средний / низкий) в верхней панели, балансируя задержку и качество.
  • Визуализация подзадач — подзадачи и субагенты, инициированные основным агентом, отображаются компактными карточками внутри соответствующей группы сообщений — с указанием ответственного агента и актуального статуса.

📁 Рабочие области уровня сессии (Session-level Workspace)

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

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

  • Настройка в окне диалога — нажмите кнопку рабочей области в поле ввода, выберите папку, и она сразу же привязывается к активной сессии.
  • Область действия — сессия — путь хранится в ключе сессии (projectSpace), поэтому при переключении сессий каждая показывает свою рабочую папку, а не общую глобальную.
  • Следующий контекст — все операции чтения/записи файлов и запуска команд в этой сессии используют рабочую область как корень, поэтому агенту не приходится каждый раз спрашивать «куда сохранять?».
  • Открытие и перепривязка — текущая рабочая область всегда видна в поле ввода; клик открывает её в системном файловом менеджере, либо можно в любой момент назначить новую.
  • Подсказка о пустом состоянии — если рабочая область не задана, поле ввода подсвечивается, чтобы предотвратить ошибочные действия.

Окно диалога

🌳 Подзадачи (Sub-tasks)

Когда основной агент порождает подзадачи или субагентов, DragonClaw автоматически отслеживает их и представляет в двух взаимодополняющих видах:

  • Встроенный вид в сообщении — карточки подзадач располагаются прямо под исходным сообщением с указанием агента-исполнителя, заголовка задачи и статуса.
  • Сводка в правой панели — откройте правую панель, чтобы увидеть сразу все подзадачи текущей сессии и их состояние выполнения.
  • Синхронизация в реальном времени — переходы состояний (pending → done) обновляются в реальном времени по мере получения событий от Gateway.

🧠 Конфигурация моделей (Model Configuration)

Конфигурация моделей — ещё одна область, где DragonClaw сияет. Там, где обычный OpenClaw заставляет вручную редактировать config.json, DragonClaw предлагает полностью графический опыт управления моделями и поставляется со встроенной поддержкой всех основных поставщиков моделей:

  • Основные поставщики встроены — OpenAI, Anthropic, DeepSeek, Grok, OpenRouter, Groq, Moonshot, Alibaba, Ollama, ModelBus, а также полностью настраиваемый «Custom Provider» — всё преднастроено, никакой ручной доводки не требуется.
  • Единое управление множеством Provider — десятки вендоров на одном экране; основную модель любой сессии можно переключить за секунды.
  • Группировка по Provider — записи автоматически группируются по Provider с логотипом, количеством моделей и длиной контекста.
  • Богатые метаданные моделей — данные из каталога models.dev: окно контекста, поддерживаемые возможности (инструменты, зрение, …), ценовой сегмент и др.
  • Визуальный CRUD — добавление модели — это несколько полей (ID, отображаемое имя, макс. токенов…), JSON писать вручную не нужно.
  • Изоляция учётных данных — API-ключи и BaseURL изолированы по Provider, не пересекаются между собой.
  • Локальные модели — полноценно — Ollama преднастроена с http://127.0.0.1:11434/v1; локальные LLM работают прямо из коробки.
  • Переключение в рамках сессии — меняйте основную модель диалога в его верхней панели без перезапуска Gateway.

Конфигурация моделей


🏪 Agents Store

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

DragonClaw поставляется со встроенным Agents Store, который позволяет просматривать и устанавливать агентов вместе с зависимыми навыками прямо из приложения:

  • Онлайн-каталог — курируемый каталог официальных и комьюнити-агентов прямо в приложении.
  • Подберите подходящего агента — фильтруйте по сценарию (разработка, писательство, офис, эксплуатация, …) и выбирайте того, кто лучше всего подходит под вашу задачу, а не довольствуйтесь тем, что уже установлено локально.
  • Установка агента и навыков одним кликом — выберите целевого агента, и он установится вместе со всеми навыками, от которых зависит, — никакой возни с зависимостями вручную.
  • Локальная кастомизация — установка полностью визуальна: аватар, ID, рабочая директория, описание персоны и т. д.
  • Представление «Мои агенты» — отдельная вкладка со всем, что вы создали, доступная для редактирования, удаления и просмотра.
  • Онлайн-обновления — когда у установленного агента выходит новая версия, обновитесь одним кликом.

Agents Store


🔄 Обнаружение обновлений (Update Detection)

DragonClaw включает универсальный механизм обновления компонентов, который автоматически запускается при старте и избавляет вас от сверки версий по разным экосистемам:

  • Автоматическая проверка при запуске — при каждом старте DragonClaw одним запросом получает актуальные версии DragonClaw, OpenClaw, Node.js и др.
  • Подписанный источник — обращение к эндпоинту api.versionCheck из config.json с идентификатором sign=dragonclaw.
  • Наглядные уведомления — при наличии новой версии боковая панель и страница настроек показывают чёткое уведомление со ссылкой на changelog.
  • Загрузка и установка в приложении — загрузка, установка и замена целиком из приложения, без блокировки главного окна.
  • Безопасный откат — сбои загрузки или несоответствие подписей не повреждают существующую установку, экран не «белеет».

🌐 Удалённый доступ (Remote Access)

Независимо от того, где работает ваш OpenClaw Gateway — на другой машине в локальной сети или на удалённом сервере, внутреннем устройстве, домашнем NAS — DragonClaw подключается к нему гибко и безопасно по токену или паролю:

  • Переключение в один клик — выберите «Удалённый режим» в меню или переключите его в боковой панели; подключение к нужному Gateway за секунды.
  • Гибкая аутентификация — поддерживаются токен и пароль, что подходит под разные политики безопасности Gateway.
  • Индикатор состояния подключения — в боковой панели в реальном времени отображается Подключение / Подключено / Отключено, есть кнопка ручного переподключения.
  • Идентичный локальному опыт — после подключения все функции (агенты, сессии, навыки, настройки, логи…) работают ровно так же, как в локальном режиме.
  • Тест подключения — до переключения можно проверить доступность целевого узла, чтобы не тратить время из-за неверной конфигурации.
  • Сохранение конфигурации — удалённый адрес, порт и токен хранятся локально в зашифрованном виде и автоматически восстанавливаются при следующем запуске.

💡 Если у удалённого устройства нет публичного IP, сочетайте DragonClaw с Tailscale, ZeroTier, frp или другими решениями для туннелирования/NAT-traversal.


📋 Панель управления (Dashboard)

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

  • Многоколоночный поток — по колонке на каждого агента; задачи двигаются внутри своей колонки, а кросс-агентное взаимодействие видно сразу.
  • Обновление в реальном времени — подзадачи и подагенты, созданные главным агентом, мгновенно отражаются в соответствующих карточках.
  • Визуализация состояний — «простаивает», «выполняется», «ошибка», «готово» отображаются разными метками, чтобы узкие места сразу бросались в глаза.
  • Обновление одним кликом — кнопка «Обновить» в шапке позволяет в любой момент подтянуть актуальное состояние, не дожидаясь push-уведомлений.

Панель управления


🧩 Управление навыками (Skill Management)

Экосистема навыков OpenClaw огромна — DragonClaw оборачивает её в полностью графический центр навыков, чтобы не приходилось править конфиги вручную:

  • Вкладки «Рекомендуемые / Все / Управление» — переключайтесь между ними сверху: новички начинают с рекомендаций, опытные — ищут в полном каталоге.
  • Поиск по ключевым словам — поле поиска фильтрует по именам и многоязычным тегам.
  • Установка/удаление одним кликом — у каждой карточки навыка есть кнопка «Установить/Удалить»; откат и переустановка столь же легки.
  • Метаданные автора и обновлений — список показывает автора, число установок и дату последнего обновления, чтобы о

Extension points exported contracts — how you extend this code

RemoteConfig (Interface)
(no doc)
src/renderer/stores/modeStore.ts
ModelItem (Interface)
(no doc)
src/renderer/stores/modelStore.ts
GroupedModels (Interface)
(no doc)
src/renderer/stores/modelStore.ts
DeviceIdentity (Interface)
(no doc)
src/renderer/core/websocket/manager.ts

Core symbols most depended-on inside this repo

request
called by 58
src/renderer/core/http/admin.ts
send
called by 56
src/renderer/core/websocket/manager.ts
withConnection
called by 56
src/renderer/api/admin-rpc.js
api
called by 52
src/renderer/api/gateway.js
save
called by 15
scripts/build-icons.py
info
called by 15
scripts/postinstall.mjs
getDB
called by 14
src/main/database/index.js
extractTextFromContent
called by 13
src/renderer/utils/messageParser.js

Shape

Function 554
Method 51
Class 6
Interface 4

Languages

TypeScript99%
Python1%

Modules by API surface

src/renderer/views/session/useSessionView.js84 symbols
src/renderer/api/gateway.js47 symbols
src/renderer/views/skill/useSkill.js41 symbols
src/renderer/core/websocket/manager.ts40 symbols
src/renderer/api/admin-rpc.js40 symbols
src/renderer/views/agent/useAgent.js36 symbols
src/renderer/views/kanban/useKanban.js22 symbols
src/main/services/updater.js22 symbols
src/renderer/views/setting/useSetting.js20 symbols
scripts/postinstall.mjs19 symbols
src/renderer/views/model/useModel.js18 symbols
src/renderer/views/log/useLog.js16 symbols

For agents

$ claude mcp add dragonclaw \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact