OmniClaw CLI
CLI и SDK на Python для платежей агента в USDC: переводы с кошельков Circle и оплата платных API по протоколу x402
- 570 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Закрытый ключ кошелька и ключи Circle открывают реальные счета, а агент с командой `pay` переводит деньги сам
- Ошибка в файле политики или завышенный бюджет позволяет потратить больше, чем вы рассчитывали
- Токены агента и владельца лежат в файле `.env` и в файле политики: утечка любого из них открывает управление платежами
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/omniclawОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Закрытый ключ кошелька и ключи Circle открывают реальные счета, а агент с командой `pay` переводит деньги сам
- Ошибка в файле политики или завышенный бюджет позволяет потратить больше, чем вы рассчитывали
- Токены агента и владельца лежат в файле `.env` и в файле политики: утечка любого из них открывает управление платежами
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OmniClaw помогает агентам и приложениям платить через контролируемые каналы, и программа не получает неограниченной власти над кошельком. Основа системы называется Financial Policy Engine, то есть движок финансовых политик. Он задает бюджеты, правила подтверждения и проверки доверия к получателю. Агенту доступна команда `omniclaw-cli`. Команда `can-pay` проверяет, разрешена ли оплата получателю, `inspect-x402` разбирает условия платной конечной точки, а `pay` совершает платеж. Для программ есть Python SDK с вызовом `OmniClaw().pay(...)`. Платежи идут по двум путям, которые задает политика: `circle_transfer` для прямых переводов с кошельков Circle Developer Wallet и x402 для оплаты платных API. Для x402 система сама выбирает наноплатеж через Circle Gateway или стандартный путь, учитывая условия продавца, настройки покупателя и баланс.
Для кого. Для разработчиков платежных сценариев с агентами, которым нужны лимиты на траты, журнал операций и проверка перед оплатой платного API.
Подходит, если
- Агенту нужно платить за вызовы платного API по протоколу x402 в пределах бюджета, который задан политикой
- Нужно проверить, можно ли заплатить получателю, до отправки денег
- Нужно повторить запрос на оплату и не получить двойное списание: `pay` принимает ключ идемпотентности
- Нужно смоделировать платеж и посмотреть журнал операций, не отправляя деньги
Не подходит, если
- Нужна сторона получателя: размещение платных конечных точек и расчеты с продавцами в ядро проекта не входят
- Платежи нужны в рублях или через банки: система работает со стейблкоином USDC и кошельками Circle
- Нужен готовый продакшен-сервис: пакет помечен как альфа-версия
- Вы не готовы хранить закрытый ключ кошелька на своей машине: без него движок политик не запустить ни в одном режиме
Пример запроса к агенту
Проверь, разрешена ли оплата по адресу платной конечной точки, разбери условия x402 и заплати 0,10 USDC с ключом идемпотентности `job-123`.Ограничения
Нужны Python 3.10 или новее и Docker: движок политик работает отдельным сервером, а CLI обращается к нему по адресу из `OMNICLAW_SERVER_URL`, в примере это http://127.0.0.1:9091. В базовом гибридном режиме нужны ключи Circle, закрытый ключ кошелька, токены агента и владельца, а также сеть и адрес RPC. Режим `OMNICLAW_BUYER_MODE=x402` обходится без ключей Circle, но закрытый ключ кошелька нужен и в нем. Состояние кошелька движок пишет в `examples/agent/buyer/runtime/wallet-state.json`, рядом с файлом политики. Последний коммит сделан в мае 2026 года.
Как отключить. Остановите контейнеры командой `docker compose down` и удалите пакет командой `pip uninstall omniclaw`. Файл `.env` с ключами и каталог `examples/agent/buyer/runtime` с состоянием кошелька удалите вручную, а токены агента и владельца замените, если они где-то сохранились.
Частые вопросы
Как установить OmniClaw и запустить движок политик?
Установите пакет командой `pip install omniclaw`, скопируйте `.env.example` в `.env` и впишите ключи. Скопируйте `examples/agent/buyer/policy.example.json` в `examples/agent/buyer/runtime/policy.json` и поправьте токен в нем, чтобы он совпал с `OMNICLAW_AGENT_TOKEN`. Затем запустите docker compose с файлом `examples/agent/buyer/docker-compose.yml`.
Что делает команда `inspect-x402`?
Она разбирает платную конечную точку API по стандарту x402 и показывает условия оплаты до того, как деньги уйдут. Сам платеж совершает команда `pay`.
Зачем два токена, агента и владельца?
Агентский токен выдают агенту: под ним агент обращается к серверу через `OMNICLAW_TOKEN`, и он должен совпадать с токеном в файле политики. Токен владельца `OMNICLAW_OWNER_TOKEN` задают отдельно, в примерах для агента он не участвует. Агенту его не отдавайте.
Есть ли у OmniClaw MCP-сервер?
Есть, он лежит в каталоге `mcp_server` и открывает кошельки, платежи и поиск по журналу операций как MCP-инструменты. Основным способом работы автор считает CLI и SDK.
Можно ли сначала попробовать без реальных денег?
Да. Ядро умеет симулировать платежи, а пример настроек MCP-сервера использует тестовую сеть ARC-TESTNET. Для первых запусков берите такую сеть и небольшие бюджеты в политике.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI с MCP-сервером и скиллом: агент вызывает платные API, а оплату по запросу HTTP 402 стейблкоинами подтверждает пользователь через Touch ID
Скилл подключает агента к платежному сервису EasyPay: продукты и инвойсы Stripe, ссылки СБП и выплаты через Т-Банк, крипта и Mercury на естественном языке
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный набор PayPal для агентов: MCP-сервер и SDK для счетов, заказов, подписок, возвратов и споров
Коллекция скиллов для крипто-агентов: кошельки, обмен токенов, ончейн-данные и протоколы Uniswap, Base, Alchemy, Zerion, каждый ставится отдельно
Официальный набор OKX для агентов: MCP-сервер на 167 инструментов, CLI и скиллы для рыночных данных, ордеров, ботов и накоплений на бирже OKX
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| OmniClaw (эта запись) | нет | 570 | |
| Pay | да | 1 799 | CLI с MCP-сервером и скиллом от Solana Foundation: оплату по запросу HTTP 402 стейблкоинами подтверждает пользователь через Touch ID |
| Bankr Skills | нет | 1 208 | коллекция скиллов для крипто-агентов: кошельки, обмен токенов и ончейн-данные |
Коротко о README
Описание проекта отделяет ядро от остальных частей: ядро отвечает за покупателя, движок политик и маршрутизацию платежей, а сторона получателя в него не входит. Быстрый старт ведет от установки пакета до запуска через Docker Compose и первой оплаты.