Caspian — скилл
Скилл помогает подключить агенту почту и мессенджеры через Caspian, сохранив общую обработку входящих сообщений
- 970 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Интеграция читает личную переписку и может отправлять сообщения от имени агента
- Облачный шлюз получает содержимое сообщений и доступы каналов
- Сообщения посторонних могут стать инструкциями для подключенного кодового агента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/caspianОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Интеграция читает личную переписку и может отправлять сообщения от имени агента
- Облачный шлюз получает содержимое сообщений и доступы каналов
- Сообщения посторонних могут стать инструкциями для подключенного кодового агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл Caspian проводит кодового агента через подключение каналов связи к приложению. По его инструкциям агент выбирает канал, ставит SDK и добавляет обработчик сообщений. Логику ответа задает ваше приложение, а Caspian доставляет сообщения в нужную переписку. Вы можете подключить существующий проект или начать с шаблона. Есть отдельные руководства, которые делают сам Claude Code или Codex доступным через сообщения. Для первого знакомства проще добавить один тестовый почтовый канал к приложению. В обычном режиме шлюз Caspian принимает входящие сообщения, а ваш процесс опрашивает его. Режим `self-host` позволяет запускать поддерживаемые адаптеры со своими токенами. Перед настройкой запросите список каналов у шлюза: общая таблица проекта может включать каналы, которые еще недоступны вашему аккаунту.
Для кого. Для разработчиков, которые добавляют своему агенту общение с людьми по почте или в рабочих чатах.
Подходит, если
- Один агент должен отвечать людям в нескольких каналах через общий обработчик
- Нужно добавить тестовый почтовый адрес к уже работающему приложению
- Для Telegram или Slack требуется связать входящее сообщение с ответом в той же переписке
- Нужно выбрать между шлюзом Caspian и адаптером на своей инфраструктуре
Не подходит, если
- Нужен готовый MCP-сервер: эта возможность пока остается в планах проекта
- Нужна только отправка сообщения в один уже настроенный канал
- Вы не можете ограничить, кто присылает команды агенту с доступом к рабочим файлам
Пример запроса к агенту
Прочитай скилл Caspian и подготовь план подключения тестовой почты к этому приложению. Покажи изменения и порядок входа, затем дождись выбора имени ящика.Ограничения
Для Python SDK нужен Python 3.10 или новее. Вариант TypeScript требует Node.js 18 или новее либо Bun. Облачный шлюз требует входа и ключа `CASPIAN_API_KEY`; работу с ним оплачивают с баланса аккаунта в `https://dashboard.trycaspianai.com`.
Лицензии расходятся: корневой `LICENSE` содержит AGPL-3.0, README называет Apache-2.0. У опубликованного npm-пакета `caspian-sdk` версии 1.0.1 указана MIT. Проверяйте условия выбранного пакета.
Для интеграции используйте опубликованный скилл и SDK. Манифест `@caspian/cli` в дереве проекта помечен `private`.
Как отключить. Остановите процесс с обработчиком Caspian и уберите вызовы интеграции из приложения. Удалите установленный скилл из клиента. Отзовите ключ Caspian и доступы каналов у соответствующих поставщиков; проверьте настроенные вебхуки, чтобы они больше не направляли сообщения в старый обработчик.
Частые вопросы
Где взять актуальный скилл Caspian?
Откройте `https://api.trycaspianai.com/SKILL.md` в кодовом агенте и выберите сценарий подключения. Для OpenClaw есть отдельная команда `clawhub install @trycaspian/caspian`.
Обязателен ли собственный публичный вебхук?
Нет для облачного режима: приложение опрашивает шлюз. Для своего адаптера способ приема зависит от канала; Slack и Discord могут использовать постоянное соединение.
Можно ли получить анонимный ключ?
Нет. Текущий шлюз требует входа через браузер. Старое описание скилла обещает анонимный тестовый ключ, но действующая инструкция этот способ больше не предлагает.
Читает ли SDK файл `.env` автоматически?
Нет. Приложение должно загрузить переменные окружения и передать ключ в `Caspian(...)`. Не добавляйте `.env` в историю Git.
Все сообщения остаются на моей машине?
Нет. В облачном режиме сообщения получают шлюз Caspian и выбранная площадка. Модель ответа тоже может получить их текст. `self-host` переносит адаптер на вашу инфраструктуру, но канал связи продолжает обрабатывать сообщения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл chat-sdk от Vercel: агент пишет ботов для Slack, Teams, Discord и Telegram на одном коде и подбирает нужные адаптеры.
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Скилл дает агенту CLI Kody для локального выполнения кода с общей памятью, пакетами и данными облачного аккаунта.
Плагин со скиллом zapier-sdk: агент пишет код для более 9000 приложений Zapier, а ключи действий берет из живого каталога
Фоновый агент для задач из Linear, GitHub, GitLab и Slack: скилл «/cyrus-setup» проведет установку от зависимостей до запуска.
CLI для обмена сообщениями между агентами: идентификаторы узлов, приглашения в контакты, входящие и связь через релей
Коротко о README
В монорепозитории лежат SDK, плагины и руководства каналов. Версия 1.x меняет прежний интерфейс `CommClient`; примеры 0.6.x нельзя переносить без проверки.
Бейдж для README
Исходный SKILL.md
# caspian: one handler, every channel
You are integrating Caspian. It gives an agent a real presence on many channels
behind ONE `on_message` handler and `thread.post()` — the same code answers on
every channel. The gateway is https://api.trycaspianai.com.
## Two ways to use this guide - ask the developer FIRST
Before doing anything else, ask your human ONE question:
A) Wire Caspian into the codebase we are in right now
(an existing agent/app gains messaging channels - continue below)
B) Scaffold a NEW custom agent from a template
(a framework is the brain; Caspian is the comms layer)
C) Make THIS coding agent reachable by message
(Claude Code / Codex / OpenCode becomes the brain, in headless mode -
you can then text your own coding agent. Powerful; read its security note.)
If C, fetch the guide for the coding agent you are:
https://api.trycaspianai.com/SKILL/claude-code-python.md
https://api.trycaspianai.com/SKILL/codex-python.md
https://api.trycaspianai.com/SKILL/opencode-python.md
If B, ask which framework, then fetch ONLY that guide and follow it:
Agent frameworks (they orchestrate the model for you):
https://api.trycaspianai.com/SKILL/openai-agents-python.md https://api.trycaspianai.com/SKILL/openai-agents-typescript.md
https://api.trycaspianai.com/SKILL/langchain-python.md https://api.trycaspianai.com/SKILL/langchain-typescript.md
https://api.trycaspianai.com/SKILL/langgraph-python.md https://api.trycaspianai.com/SKILL/langgraph-typescript.md
https://api.trycaspianai.com/SKILL/claude-agent-sdk-python.md https://api.trycaspianai.com/SKILL/claude-agent-sdk-typescript.md