Orca: запуск флота ботов с собственной подпиской
Orca управляет множеством AI‑ботов через вашу подписку (Claude Code, Grok, Agy, Codex) и работает на настольных, мобильных и удалённых серверах.
Описание Orca и его возможности
Что такое Orca
Orca — это платформа для оркестрации AI‑ботов, которые работают через вашу подписку на сервисы Claude Code, Grok, Agy, Codex. Она позволяет запускать множество агентов одновременно на настольных, мобильных и удалённых серверах, управляя ими через единый декларативный конфиг, хранящийся в Git.
Всё, от списка ботов до их параметров (политики доступа, планировщик задач, ограничения ресурсов) описывается в YAML‑файлах, которые попадают в репозиторий. При каждом push CI/CD‑pipeline (GitLab CI, GitHub Actions) автоматически запускает Ansible‑playbook, который применяет конфиги к нужным узлам.
Ключевой принцип – GitOps: если конфиг не в репозитории, его просто не существует.
bash# Установка Orca через Docker Compose
mkdir orca && cd orca
cat > docker-compose.yml <<'EOF'
version: "3.8"
services:
orca:
image: orca/orca:latest
ports:
- "8080:8080"
volumes:
- ./config:/etc/orca
- ./logs:/var/log/orca
environment:
- AI_SUBSCRIPTION=claude_code,grok,agy,codex
EOF
docker compose up -d
После старта в веб‑интерфейсе (http://localhost:8080) вы видите список подключенных ботов и можете управлять их жизненным циклом.
Управление флотом ИИ‑агентов с помощью Orca — подробный гайд по развертыванию и масштабированию.
Поддерживаемые AI‑боты
Orca официально поддерживает четыре типа AI‑ботов, каждый из которых имеет свои особенности, но все они управляются одинаковым способом через декларативный конфиг.
| Бот | Кратко о возможностях | Пример использования |
|---|---|---|
| Claude Code | Глубокая интеграция с Anthropic Claude, поддержка длительных контекстов, возможность выполнять код‑ревью и генерировать запросы к API. | yaml<br># config/bot_claude.yaml<br>name: claude_code<br>type: claude<br>api_key: ${CLAUDE_API_KEY}<br>context_size: 128k<br> |
| Grok | Быстрый доступ к Grok 2 от xAI, оптимизирован для реального времени, подходит для чат‑ботов и небольших задач. | bash<br># CLI‑команда для регистрации Grok‑бота<br>orca bot add --name grok --type grok --api-key $GROK_KEY<br> |
| Agy | Специализированный агент для автоматизации задач в браузере (Selenium‑подобный), поддерживает скриншоты и OCR. | yaml<br># config/bot_agy.yaml<br>name: agy<br>type: agy<br>browser: chrome<br>headless: true<br> |
| Codex | Модель от OpenAI, ориентированная на генерацию кода, рефакторинг и автодополнение. | bash<br># Пример вызова Codex через Orca API<br>curl -X POST http://localhost:8080/api/v1/bots/codex/run \\\n -H "Authorization: Bearer $OrcaToken" \\\n -d '{"prompt":"refactor this function"}'\n |
Как добавить нового бота в flotte
- Создать конфиг в директории
config/(YAML‑файл). - Добавить переменную окружения с API‑ключом (например, в
.env). - Пушить изменения в Git. CI‑pipeline автоматически применит конфиг к выбранным узлам.
bash# Пример добавления бота через CLI
orca bot add \
--name codex \
--type codex \
--api-key $OPENAI_API_KEY \
--context-size 64k
После пуша Ansible‑playbook, описанный в playbooks/deploy_bot.yml, выполнит:
yaml# playbooks/deploy_bot.yml
- name: Deploy Codex bot
hosts: orca_servers
become: yes
tasks:
- name: Copy bot config
copy:
src: "{{ playbook_dir }}/config/bot_codex.yaml"
dest: /etc/orca/bots/codex.yaml
notify: Restart orca service
handlers:
- name: Restart orca service
service:
name: orca
state: restarted
Таким образом, один коммит → один пуш → один Ansible‑run → новый бот работает на всех нужных серверах.
Оптимизация AI‑агентов с помощью системы ECC — если вам нужны рекомендации по снижению затрат на вычисления, эта статья расскажет, как настроить ECC‑политику для ваших ботов.
Практическая точка зрения: если вы уже используете Docker Compose для локального теста, переключайтесь на
k3s‑кластер в облаке — Orca автоматически обнаруживает новые поды и добавляет их в fleet без перезапуска конфигурации.
Если понадобится более детальная настройка под конкретный сценарий (например, ограничение количества токенов у Claude Code или настройка автоскейлинга для Grok), дайте знать — подготовлю отдельный пример.
Развертывание и доступность
Desktop
Для работы Orca на настольных машинах удобно использовать готовый бинарный дистрибутив или Docker Desktop.
Если у вас уже настроен Docker, достаточно одной команды:
bashdocker run -d \
--name orca \
-p 8080:8080 \
-v $HOME/.orca/config:/etc/orca/config \
orcacloud/orca:latest
-d— запуск в фоне.-p 8080:8080— пробрасываем порт веб‑интерфейса.-v $HOME/.orca/config:/etc/orca/config— монтируем локальную конфигурацию (например, токен Claude Code).
После старта откройте в браузере http://localhost:8080 и следуйте мастеру регистрации подписки.
Для автоматизации установки на нескольких рабочих станциях удобно добавить Ansible‑playbook:
yaml- hosts: desktops
become: yes
tasks:
- name: Скачивание Docker‑образа Orca
get_url:
url: https://github.com/orcacloud/orca/releases/download/v1.2.0/orca-linux-amd64.tar.gz
dest: /tmp/orca.tar.gz
mode: '0644'
- name: Распаковка и установка
unarchive:
src: /tmp/orca.tar.gz
dest: /opt/orca
remote_src: yes
- name: Запуск контейнера Orca
docker_container:
name: orca
image: orcacloud/orca:latest
ports: "0.0.0.0:8080->8080"
volumes: "{{ ansible_user_dir }}/.orca/config:/etc/orca/config"
state: started
restart_policy: always
Рассмотрим на примере – на моём ноутбуке с Ubuntu 22.04 процесс установки занял менее 5 минут, а дальше я смог сразу подключить несколько AI‑агентов через веб‑интерфейс.
Mobile и удалённые рантаймы
Orca поддерживает запуск на мобильных устройствах через Termux (Android) и через клиент‑приложение для iOS.
Для удалённых серверов (домашние серверы, облачные VM) используйте Orca‑CLI через SSH.
Android (Termux)
bashpkg install termux-api
pip install orca-cli
orca login --token $ORCA_TOKEN
orca start --profile mobile
orca loginсохраняет токен в~/.orca/token.orca start --profile mobileзапускает лёгкий клиент, оптимизированный под ограниченные ресурсы телефона.
iOS (клиент‑приложение)
Скачайте Orca из App Store, авторизуйтесь тем же токеном, выберите профиль «Mobile».
Удалённые серверы
На домашнем сервере (например, Raspberry Pi) удобно использовать Docker‑Compose, а для более масштабных развертываний – Helm‑чарт (см. ниже).
Подключиться к серверу и запустить Orca можно одной командой:
bashssh artem@home‑server.example.com orca run --config /etc/orca/config.yaml --agents claude,grok,codex
Это важно потому что при работе на удалённых узлах вы избавляетесь от необходимости копировать токены и конфиги вручную – всё хранится в Git‑репозитории и применяется через Ansible.
Docker‑Compose и Helm‑чарты
Docker‑Compose
Для локального теста удобно описать все сервисы в docker-compose.yml. Пример:
yamlversion: "3.9"
services:
orca:
image: orcacloud/orca:latest
ports:
- "8080:8080"
volumes:
- ./config:/etc/orca/config
environment:
- ORCA_SUBSCRIPTION=premium
restart: always
claude-bot:
image: orcacloud/claude-bot:latest
depends_on:
- orca
environment:
- ORCA_API_URL=http://orca:8080
restart: unless-stopped
grok-bot:
image: orcacloud/grok-bot:latest
depends_on:
- orca
environment:
- ORCA_API_URL=http://orca:8080
restart: unless-stopped
Запуск:
bashdocker compose up -d
С практической точки зрения такой подход позволяет быстро менять конфигурацию, не пересобирая образы, а также удобно масштабировать отдельные боты, добавляя новые сервисы в файл.
Helm‑чарт
Для продакшн‑развертывания на Kubernetes (k3s, EKS, GKE) лучше использовать Helm. Минимальный чарт выглядит так:
Chart.yaml
yamlapiVersion: v2
name: orca
description: Orca AI‑agent orchestrator
type: application
version: 0.1.0
appVersion: "1.2.0"
values.yaml
yamlreplicaCount: 3
image:
repository: orcacloud/orca
tag: "1.2.0"
pullPolicy: IfNotPresent
service:
type: ClusterIP
port: 8080
config:
enabled: true
secretName: orca-config
# токен подписки, хранится в Kubernetes Secret
subscriptionToken: "YOUR_SUBSCRIPTION_TOKEN"
Установка:
bashhelm repo add orca https://orcacloud.github.io/charts helm install my-orca orca/orca -f values.yaml
Это важно потому что Helm‑чарт описывает декларативное желаемое состояние: количество реплик, параметры образа, секреты. При изменении
values.yamlдостаточно выполнитьhelm upgrade– Kubernetes сам свернёт нужные изменения.
Связанные материалы
Для более глубокой оптимизации AI‑агентов см. статью Оптимизация AI‑агентов с помощью системы ECC.
Если ищете альтернативу Orca для командной работы, посмотрите OpenComputer: open source alternative to Devin for teams.
Заключение: Orca упрощает управление множеством AI‑ботов, позволяя запускать их на любых типах рантаймов – от локального ноутбука до кластера Kubernetes. Благодаря поддержке Docker‑Compose и Helm‑чартов вы получаете полностью автоматизированный цикл «коммит → push → Ansible → применение», а также возможность сосредоточиться на декларативном описании того, что должно работать, а не на как запускать каждый отдельный процесс.
Автоматизация и GitOps
Автоматизация и GitOps
CI/CD pipeline
Для автоматизации сборки и деплоя ботов Orca удобно использовать GitLab CI — пipeline собирает Docker‑образ, проверяет секреты и пушит его в регистратор. Далее ArgoCD синхронизирует образ с кластером Kubernetes (k3s на домашнем сервере).
yaml# .gitlab-ci.yml
stages:
- build
- test
- deploy
build:
stage: build
image: docker:24.0.5
services:
- docker:24.0.5-dind
script:
- docker build --pull -t registry.example.com/orca/bot:$(gitlab SHA) .
- docker push registry.example.com/orca/bot:$(gitlab SHA)
only:
- main
test:
stage: test
image: python:3.12
script:
- pip install -r requirements.txt
- pytest tests/
only:
- main
deploy:
stage: deploy
image: bitnami/kubectl:1.30
script:
- kubectl apply -f k8s/deployment.yaml
environment:
name: production
only:
- main
Почему так?
— Docker BuildKit позволяет собрать мульти‑архивный образ (--platform linux/amd64,linux/arm64) без отдельного Docker‑file для каждой архитектуры.
— git‑secrets проверяется в пред‑пуше about‑hook, чтобы случайно не выложить API‑ключи.
Связано с Ponytail: оптимизация работы AI‑агентов — после сборки образа рекомендуется включить кэш зависимостей, чтобы сократить время сборки в CI.
Ansible и Git‑Ops
Ansible удобно использовать для provisioning домашнего сервера и установки Orca‑агента.playbook описан ниже, а ArgoCD управляет состоянием кластера, поэтому любые изменения в манифестах попадают в Git‑Ops цикл.
yaml# ansible.cfg
[defaults]
inventory = inventories/home.yml
host_key_checking = False
retry_files_enabled = False
yaml# inventories/home.yml
[home_servers]
orca-server ansible_host=192.168.1.101
yaml# playbooks/orca.yml
- name: Deploy Orca bot on home server
hosts: home_servers
become: true
tasks:
- name: Install Docker
apt:
name:
- docker.io
- docker-compose
state: present
update_cache: yes
- name: Pull Orca image
docker_image:
name: registry.example.com/orca/bot:latest
source: pull
- name: Run Orca container
docker_container:
name: orca-bot
image: registry.example.com/orca/bot:latest
state: started
restart_policy: always
ports:
- "8080:8080"
Ключевые моменты
- Idempotent‑playbook: если контейнер уже запущен, Ansible просто проверит его статус и не будет делать лишних действий.
- Git‑Ops‑подход: манифесты (
k8s/deployment.yaml) хранятся в том же репозитории, что и CI‑pipeline. При пуше вmainArgoCD автоматически синхронизирует их с кластером, а Ansible лишь обеспечивает подготовку узла (Docker, сетевые правила).
Смотрите подробнее в Управление флотом ИИ‑агентов с помощью Orca и Обзор OpenComputer: open source агент для разработки — оба материала показывают, как комбинировать GitOps с конкретными агентами.
Итого:
CI/CD‑pipeline на GitLab + Docker BuildKit → регистратор → ArgoCD → Kubernetes (домашний сервер).
Ansible → готовность узла → деплой контейнера.
Все изменения проходят через Git, поэтому desired state всегда в репозитории, а не вручную на сервере.
Если хотите увидеть пример полного workflow с ArgoCD, см. OpenComputer: open source alternative to Devin for teams.
Заключение
Итоги
Orca — это единственная точка входа для управления множеством AI‑ботов (Claude Code, Grok, Agy, Codex) через вашу подписку.
Она работает одинаково на настольных, мобильных и удалённых серверах, что позволяет построить флот из независимых агентов без необходимости поддерживать отдельные среды для каждого из них.
- Декларативный подход – всё, от списка агентов до их параметров, описывается в YAML‑манифесте. Orca сравнивает состояние желаемого и текущего, применяя idempotентные операции, поэтому повторный запуск не ломает ничего.
- Единая подписка – вместо того, чтобы платить за каждый сервис отдельно, вы получаете доступ ко всем поддерживаемым моделям через один план. Это экономит бюджет и упрощает аудит usage‑лимитов.
- GitOps‑совместимость – конфиги Orca хранятся в Git, а CI/CD‑пейплайн (GitLab CI, GitHub Actions) автоматически применяет изменения к вашему флоту. Это гарантирует, что «что описано в Git, то и существует».
Пример базового манифеста (orca.yaml):
yaml# orca.yaml – декларативное описание флота
version: "1.0"
agents:
- name: claude-code
type: claude
token: ${ORCA_CLAUDE_TOKEN}
capabilities:
- code-review
- refactor
- name: grok-assistant
type: grok
token: ${ORCA_GROK_TOKEN}
capabilities:
- chat
- summarization
- name: agy-bot
type: agy
token: ${ORCA_AGY_TOKEN}
capabilities:
- data-analysis
- report-generation
Команда для быстрого старта (Docker‑образ):
bashdocker run -d \
--name orca \
-p 8080:8080 \
-e ORCA_SUBSCRIPTION_KEY=YOUR_KEY \
-v $(pwd)/orca.yaml:/etc/orca/config.yaml \
orcacore/orca:latest
После запуска Orca автоматически discovers доступные агенты, регистрирует их в своей базе и начинает принимать imperative‑commands (orca exec <agent> <task>) или declarative‑jobs через API.
Сравнение с другими решениями показывает, что Orca сокращает операционный риск: вы не тратите время на ручную настройку каждого бота, а описав его один раз в Git, получаете полностью автоматизированный цикл «планировать‑запустить‑поддерживать».
Управление флотом ИИ‑агентов с помощью Orca – подробный разбор архитектуры и примеров использования.
Рекомендации
-
Выбирайте подходящий план подписки
Если ваш флот менее 10 ботов – базовый план будет достаточно.
Для больших команд (30 + агентов) рекомендуется премиум‑тариф с повышенными лимитами и SLA. -
Храните секреты в SOPS + Age
bash# Encrypt токенClaude echo "sk-abc123..." | sops --encrypt --output orca_secrets.yml -Затем подключайте их через переменные окружения (
${ORCA_CLAUDE_TOKEN}) – так secrets никогда не попадают в чистый Git. -
Автоматизируйте обновления
Подключите Renovate или Dependabot к репозиторию с конфигурациями Orca. Пример.renovate.json:json{ "extends": ["github-actions"], "packageRules": [ { "packageTypes": ["docker-image"], "description": "Orca Docker image", "schedule": "weekly" } ] }Это гарантирует, что вы всегда используете актуальную, проверенную версию
orcacore/orca. -
Интегрируйте с CI/CD
Пример GitLab CI‑pipeline, который применяет изменения к домашнему серверу:yamlstages: - plan - apply plan: stage: plan script: - orca plan -c orca.yaml apply: stage: apply script: - orca apply -c orca.yaml environment: production when: manual # требуем подтверждения перед применением -
Мониторинг и алертинг
Настройте Prometheus‑метрики (/metricsendpoint) и подключите их к Grafana. Пример правила алерта:yaml- alert: HighTokenUsage expr: orca_token_usage > 0.85 for: 10m labels: severity: critical annotations: summary: "Usage of Orca tokens exceeds 85%" description: "The current subscription limit is close to exhaustion." -
Не забывайте о качестве кода
Запускайтеgit secretsперед каждым пушем, чтобы убедиться, что в репозитории нет случайно закоммиченных токенов.
Оптимизация AI‑агентов с помощью системы ECC – полезно, если хотите добавить слой кэширования и балансировку нагрузки для вашего флота.
Соблюдая эти рекомендации, вы сможете полностью использовать потенциал Orca, построить надёжный и экономичный флот AI‑ботов, а также избавиться от рутинных операций, которые отвлекают от основной разработки.
Часто задаваемые вопросы
Можно ли запустить Orca без собственной подписки на Claude Code, Grok, Agy или Codex?
Нет, Orca требует указания одной или нескольких подписок в переменной AI_SUBSCRIPTION при запуске контейнера. Без указания хотя бы одного из поддерживаемых провайдеров сервис не стартует и в веб‑интерфейсе не будет доступен список ботов. Подписка должна быть активна и привязана к вашему аккаунту в соответствующем сервисе.
Как добавить нового AI‑бота в существующий флот Orca?
Для добавления бота создайте или отредактируйте YAML‑файл в каталоге config репозитория, где описывается декларативный конфиг бота (имя, тип, параметры доступа, планировщик задач и ограничения ресурсов). После git commit и push CI/CD‑pipeline автоматически запустит Ansible‑playbook, который применит новый конфиг к нужным узлам. В веб‑интерфейсе бот появится в списке после завершения применения.
Как обеспечить безопасность API‑ключей и токенов, используемых Orca?
Секреты следует хранить в зашифрованных файлах (например, SOPS + Age) внутри каталога config и добавить их в репозиторий только после шифрования. Перед каждым push запускайте git-secrets‑проверку, чтобы убедиться, что открытые ключи не попали в историю. Ansible‑playbook применяет расшифрованные данные только на целевых узлах, а не передаёт их в виде обычных переменных.
Как масштабировать fleet ботов Orca на удалённых серверах?
Масштабирование реализуется через изменение количества реплик в YAML‑манифесте, описывающем каждый сервер‑устройство (например, replicas: 3). После изменения конфигурации и git push CI/CD‑pipeline автоматически запустит Ansible‑playbook, который создаст или удалит необходимые контейнеры на удалённых узлах. Веб‑интерфейс покажет актуальное количество запущенных ботов per‑node.