Устанавливаемый Skill
Сделайте TwtAPI Skill, который можно установить сразу
Если вы не хотите заставлять пользователей начинать с API-документации и кода запросов, отдайте им устанавливаемый Skill. Hosted gateway уже готов, поэтому достаточно сгенерировать skill_key и выполнить короткую настройку в OpenClaw или совместимом runner.
Настройка занимает мало времени
Публичный Skill берет на себя hosted entrypoint, поэтому обычно хватает трех действий.
Сгенерировать skill_key в dashboard
Выполнить clawhub install twtapi
Добавить TWTAPI_SKILL_KEY в переменные окружения или конфиг
Почему Skill
Упакованный API внедряется быстрее
Skill лучше подходит тем пользователям, которым нужно быстро начать работу с TwtAPI без прямой интеграции сырого API.
Ниже порог входа
Пользователь начинает с установки и настройки, а не с чтения документации и написания запросов.
Ближе к готовому продукту
Skill легче передать как готовую возможность, чем просто ссылку на API reference.
Отдельный контур авторизации
Выделенный skill_key изолирует доступ Skill от основного API-ключа.
Удобно для agent workflows
Совместимые runners могут напрямую использовать возможности TwtAPI внутри агентных и автоматизационных сценариев.
Лучшие сценарии
Когда Skill удобнее, чем сырой API
Если цель — быстрый старт, а не глубокая кастомная интеграция, Skill обычно оказывается удобнее.
Передача неразработчикам
Если пользователю нужна готовая возможность, а не собственная реализация поверх API, Skill проще.
Внутреннее распространение
Одна команда установки и один шаблон конфигурации позволяют быстро подключить разные роли в команде.
Agent и automation stacks
Когда нужно встроить Twitter-возможности в runner или систему автоматизации, формат Skill подходит особенно хорошо.
Быстрый старт
Публичный Skill ставится в 3 шага
Слой gateway уже хостится, поэтому на стороне пользователя нужны только key и короткая локальная настройка.
1. Сгенерировать Skill Key
Откройте вкладку Skill в dashboard и создайте или обновите skill_key с префиксом `tsk-`.
2. Установить публичный Skill
В поддерживаемой среде выполните `clawhub install twtapi`, чтобы установить публичный TwtAPI Skill.
3. Добавить конфиг и перезапустить
Укажите `TWTAPI_SKILL_KEY` в переменных окружения или конфиге, затем перезапустите runner.
Шаблоны установки
Обычно достаточно этих трех фрагментов
Их можно сразу отдавать пользователям как стандартный сценарий настройки публичного Skill.
Команда установки
Сначала установите публичный пакет Skill `twtapi`.
После установки добавьте сгенерированный skill_key и перезапустите клиент или runner.
clawhub install twtapi
Переменная окружения
Самый простой вариант — хранить skill_key в переменной окружения.
Замените `tsk-your-skill-key` на реальное значение из dashboard.
export TWTAPI_SKILL_KEY="tsk-your-skill-key"
Шаблон конфига
Если клиент использует конфиг-файл, Skill можно описать напрямую.
Сохраните шаблон после замены примера key и перезапустите runner.
{
"skills": {
"entries": {
"twtapi": {
"enabled": true,
"env": {
"TWTAPI_SKILL_KEY": "tsk-your-skill-key"
}
}
}
}
}Частые вопросы
Частые вопросы
Поставляйте TwtAPI как устанавливаемый Skill для OpenClaw и совместимых runners. Публичный Skill уже включает hosted gateway, поэтому пользователю нужен только отдельный skill_key.
Чем Skill отличается от MCP?
MCP нужен для AI-клиентов с протоколом MCP. Skill — это устанавливаемый формат поставки, который удобен для skill runners и простой дистрибуции.
Нужно ли пользователю хостить gateway?
Нет. Публичный Skill уже включает hosted gateway, поэтому пользователю нужен только собственный skill_key.
Зачем отдельный skill_key?
Он отделяет доступ Skill от основного API-ключа и упрощает ротацию, контроль доступа и диагностику.
Сначала дайте пользователю устанавливаемый вход, а потом решайте, нужен ли полный API-интеграционный путь
Если важна быстрая активация, публичный Skill часто внедряется проще, чем сырые API-документы с первого дня.