Claw Skill
Claw Skill предоставляет агентам в экосистеме OpenClaw возможности интеграции с aihelpme.ru: загрузку документов, импорт веб-страниц и поиск по нескольким базам через REST API.
Навык размещён на ClawHub, имя пакета — @lyingbug/weknora, лицензия MIT-0. Доступные возможности и права определяются API aihelpme.ru, к которому выполнено подключение.
Основные возможности
| Возможность | Соответствующий интерфейс |
|---|---|
| Загрузка файлов | Отправка документов PDF / Word / Excel и других в базу знаний с автоматическим разбором и векторизацией |
| Импорт веб-страниц | Извлечение основного текста по URL с записью в базу знаний, поддерживается опрос статуса разбора |
| Запись Markdown | Создание или редактирование знания в формате Markdown, подходит для протоколов встреч и структурированных заметок |
| Гибридный поиск | hybrid-search в одной базе и knowledge-search между базами, извлечение по векторам + ключевым словам |
| Просмотр баз знаний | Список баз знаний и записей, просмотр деталей |
Установка и подключение
В разделе «Настройки → Интеграции публикации → Claw Skill» смотрите руководство по установке, скопируйте адрес API текущего экземпляра, пример переменных окружения и команду установки.
- Получите учётные данные API: в разделе «Настройки → Интеграции публикации → Интеграция API» скопируйте API Key и адрес API (кнопка «Открыть информацию об API» на странице руководства ведёт сюда же);
- Задайте переменные окружения: в терминале или в
~/.zshrc/~/.bashrcзадайте
export WEKNORA_BASE_URL=https://your-weknora.example.com/api/v1
export WEKNORA_API_KEY=sk-xxxxxWEKNORA_BASE_URL должен включать /api/v1; в примере на странице руководства уже подставлен адрес текущего экземпляра.
- Установите Skill: в окружении с установленным OpenClaw CLI выполните следующую команду или установите по инструкции на странице ClawHub;
openclaw skills install @lyingbug/weknora- Проверка: попросите агента один раз вывести список баз знаний или выполнить поиск, чтобы убедиться в доступности учётных данных и сети.
Связь с MCP
Claw Skill и MCP Server оба могут вызываться внешними агентами; выбор зависит от поддерживаемого клиентом способа подключения и нужных функций:
| Claw Skill | MCP Server (встроенный) | |
|---|---|---|
| Для кого | Агенты экосистемы OpenClaw / ClawHub | Клиенты с поддержкой протокола MCP (Claude Desktop, Cursor, Claude Code, VS Code Copilot и др.) |
| Установка | Установка Skill из ClawHub | Дополнительное развёртывание не требуется: создайте эндпоинт в «Настройки → Интеграции публикации → MCP Server» и подключите клиент к /mcp/<endpoint_id> |
| Аутентификация | API Key пространства (WEKNORA_API_KEY) | Отдельный токен на каждый эндпоинт, можно ротировать и отключать |
| Транспорт | Прямой вызов REST | Streamable HTTP; клиенты, поддерживающие только stdio, подключаются через мост mcp-remote |
| Объём возможностей | Импорт, поиск, просмотр (5 категорий) | Выбирается для эндпоинта: поиск и чтение, вопросы-ответы (по умолчанию эндпоинт использует Agent), Wiki, запись; можно ограничить базами знаний |
| Документация | Эта страница | Интеграция MCP |
Когда нужны вопросы-ответы, инструменты Wiki или хочется ограничить инструменты и базы знаний для эндпоинта, используйте MCP Server; для импорта, поиска и просмотра материалов в экосистеме OpenClaw можно использовать Claw Skill. Python MCP-сервис в каталоге mcp-server/ репозитория устарел; для новых подключений используйте встроенный MCP Server.
Связанные документы
- Учётные данные и сужение возможностей: Тенанты, пользователи и авторизация
- Нижележащие интерфейсы: Обзор API
- Другие способы интеграции: Chrome-расширение, Интеграция MCP