Почему OpenClaw нужен GitHub-процесс
Агенты в стиле OpenClaw полезны тем, что продолжают работать после первого промпта. Эта же сила делает дисциплину в GitHub обязательной: один агент может изменить десятки файлов, другой — починить тесты, третий — проверить diff. Без шаблона веток и pull request команда получает пачку изменений без понятного владельца.
Office Claws не является нативной runtime для OpenClaw. Мы применяем тот же операционный урок к агентам на Codex: одна задача получает один раннер, одну ветку, один поток логов и один проверяемый PR. Если вы сравниваете runtime, начните с OpenClaw vs Codex, а затем используйте процесс ниже как безопасный слой GitHub вокруг любого варианта.
Шаблон веток OpenClaw
Дайте каждому агенту ветку до того, как он начнет писать код. Название ветки должно объяснять ревьюерам, что произошло, без открытия PR. Нам нравится такой формат:
agent/<ticket-or-topic>-<short-purpose>
fix/<bug>-agent
docs/<topic>-agentНебольшая дисциплина именования предотвращает две частые ошибки: агенты пушат в main, а люди теряют понимание, какой раннер владеет каким diff. В Office Claws desktop-представление связывает задачу с раннером и потоком логов; ветка GitHub — такой же идентификатор в системе контроля версий.
| Шаг | Владелец | Гейт | Какой сбой предотвращает |
|---|---|---|---|
| Создать ветку | Человек или диспетчер | Название содержит задачу | Агент меняет main |
| Запустить агента | Изолированный раннер | Один worktree на задачу | Конфликты файлов между агентами |
| Запушить draft PR | Агент | CI стартует сразу | Скрытые локальные изменения |
| Проверить diff | Человек или агент-ревьюер | Обязательное одобрение | Тихой дрейф архитектуры |
| Слить | Человек | Зеленая CI | Сломанная production-ветка |
Полезное правило простое: агент может предложить код, но не принимает финальное решение об интеграции.
CI-гейты до ревью агентом
Запускайте скучные проверки до того, как просить другого агента ревьюить работу. Агент-ревьюер намного лучше замечает архитектуру, крайние случаи и недостающие тесты, когда не тратит контекст на ошибку форматирования TypeScript.
Минимальный GitHub Actions-гейт для web-репозитория рядом с OpenClaw выглядит так:
name: agent-pr
on:
pull_request:
branches: [main]
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm run lint --if-present
- run: npm test --if-present
- run: npm run buildДля пользователей Office Claws именно здесь окупается desktop-менеджер: держите coding-агента на VPS, храните ключи провайдера локально и превращайте GitHub в нейтральное место, где люди проверяют финальный diff. См. Office Claws для пользователей OpenClaw про слой управления и OpenClaw на VPS про архитектуру раннеров.
Безопасные передачи между агентами
Передача должна быть явной. Не говорите агенту-ревьюеру «проверь репозиторий». Скажите, какой PR, какие тесты прошли, что изменилось и какой риск нужно проверить.
Review PR #42 on branch agent/billing-export.
CI is green. Focus on data-loss risk, auth boundaries, and migration rollback.
Do not push unless you create a separate reviewer branch.
Return: blocking issues, non-blocking suggestions, and merge recommendation.Держите права такими же явными:
- Coding-агенты могут пушить только в свои ветки.
- Агенты-ревьюеры могут комментировать, но не сливать.
- Release-токены не находятся на раннерах агентов.
- Люди сохраняют финальную кнопку merge.
Эта модель подходит для OpenClaw, Codex или любой будущей runtime агентов. Важен не бренд агента, а граница ревью вокруг кода, который он пишет.
Рекомендуемый процесс
- Начинайте каждую задачу из свежей ветки и изолированного worktree.
- Позволяйте агенту рано пушить draft PR, даже до завершения работы.
- Требуйте CI до обратной связи от агента-ревьюера.
- Держите ключи провайдера и release-учетные данные вне раннера.
- Сливайте только после того, как человек прочитал summary PR, вывод тестов и рискованные файлы.
Если вы переходите от случайных OpenClaw-сессий к процессу, которому может доверять команда, этот GitHub-процесс — первая привычка. Office Claws дает командам в стиле OpenClaw desktop-управление, изоляцию VPS-раннеров, выполнение через Codex и более безопасное локальное хранение ключей, чтобы эти привычки было проще поддерживать.
Связанные материалы
- OpenClaw vs Codex — где подходит каждая runtime.
- OpenClaw Desktop Manager — слой управления Office Claws для работы в стиле OpenClaw.
- OpenClaw Security Best Practices — хранение ключей, изоляция раннеров и audit logs.