Управление ИИ-агентами обычно означает борьбу с окнами терминала, SSH-сессиями и разбросанными конфигурационными файлами. Office Claws заменяет всё это одним CLI — плюс десктопным приложением с пиксельным офисом, где каждый агент сидит за своим столом. Каждый агент работает на VPS в вашем собственном аккаунте Contabo и общается с вашим компьютером через вашу собственную сеть Tailscale. Это руководство проведёт вас через каждый шаг настройки — от установки CLI до первого разговора с агентом.
Что вам понадобится перед началом
Подготовьте всё перечисленное заранее — тогда настройка займёт всего несколько минут.
Аккаунты и учётные данные
- Подписка Office Claws. Тариф один — Self-Hosted за $4.99/месяц. Без активной подписки развернуть агента нельзя — оформить её можно прямо из CLI на шаге 2.
- Аккаунт Contabo с VPS. Ваш агент работает на VPS в вашем собственном аккаунте Contabo, и за сервер вы платите Contabo напрямую — небольшой VPS стоит несколько евро в месяц. Закажите VPS в Contabo до начала онбординга. Office Claws запускает одного агента на один VPS.
- API-доступ к Contabo. Откройте my.contabo.com/api/details и запишите Client ID и Client secret (в разделе «API Data»), API user (email, с которым вы входите в Contabo) и API password. API-пароль — это не пароль от входа на сайт; если вы его ещё не задавали, нажмите на этой странице «Set password».
- Аккаунт Tailscale и ключ авторизации. Tailscale создаёт зашифрованную сеть между вашим компьютером и VPS агента. Создайте бесплатный аккаунт на tailscale.com, затем сгенерируйте ключ в консоли администратора: Settings > Keys > Generate auth key.
- Подписка ChatGPT с Codex. Агент работает на вашей собственной подписке OpenAI Codex (ChatGPT), которую вы подключаете входом через браузер на шаге 5. API-ключ не нужен.
- Компьютер на macOS или Linux с установленным и подключённым Tailscale. CLI обращается к агентам через ваш tailnet.
Запустите первого агента примерно за 3 минуты
Установите CLI Office Claws, подключите аккаунт Contabo и подписку Codex — агент получит собственный VPS и рабочее место в офисе.
curl -fsSL https://officeclaws.com/downloads/install.sh | sh$4.99/мес + ваш собственный VPS в Contabo · ключи остаются в вашей связке ключей
Как устроены цены
У Office Claws один тариф: Self-Hosted, $4.99/месяц. В него входят CLI, десктопное приложение с пиксельным офисом, чат с агентами в реальном времени, логи, задачи по расписанию и каналы вроде Telegram. Инфраструктура остаётся вашей: VPS находится в вашем аккаунте Contabo и оплачивается Contabo, а модель работает на вашей собственной подписке Codex.
Бесплатного пробного периода нет — для развёртывания нужна активная подписка. Возвраты регулируются нашей Политикой возврата.
Шаг 1: Установите CLI
Установите CLI officeclaws одной командой:
curl -fsSL https://officeclaws.com/downloads/install.sh | shВыполните officeclaws version, чтобы убедиться, что он доступен в PATH. Предпочитаете графический интерфейс? Десктопное приложение с пиксельным офисом доступно на главной странице и работает с тем же аккаунтом и теми же агентами.
Шаг 2: Создайте аккаунт и оформите подписку
officeclaws register # или: officeclaws login
officeclaws subscriberegister создаёт аккаунт Office Claws по email и паролю; если аккаунт уже есть, используйте login. subscribe открывает страницу оплаты в браузере (если браузер открыть не удалось, команда выведет ссылку). Как только оплата пройдёт, аккаунт готов к развёртыванию агентов.
Шаг 3: Пройдите онбординг первого агента
officeclaws onboard --name MonaОнбординг интерактивный. Он:
- Проверяет, что подписка активна. Если нет — отправляет вас к
officeclaws subscribe. - Запрашивает четыре параметра API-доступа к Contabo и проверяет их. Они сохраняются в системной связке ключей, так что вводить их нужно только один раз.
- Запрашивает ключ авторизации Tailscale — он тоже сохраняется в связке ключей.
- Создаёт SSH-ключ, с помощью которого CLI подключается к вашим агентам.
- Синхронизирует список VPS в вашем аккаунте Contabo и предлагает выбрать тот, который станет агентом.
Если не указать --name, онбординг спросит имя. Два необязательных флага персонализируют агента: --comm-style friendly|business|creative задаёт тон общения, а --avatar выбирает один из 12 пиксельных аватаров для офиса в десктопном приложении. Для каждого вопроса есть и флаг (--contabo-client-id, --tailscale-authkey, --vps и т. д.), поэтому онбординг можно запустить полностью неинтерактивно — officeclaws help покажет их все.
Шаг 4: Следите за развёртыванием
После выбора VPS Office Claws разворачивает его и выводит прогресс прямо в терминал:
- Устанавливает агента из готового образа Office Claws.
- Подключает VPS к вашей сети Tailscale.
- Усиливает защиту сервера и запускает среду агента в Docker.
- Настраивает шлюз агента, доступный только через ваш tailnet.
Весь процесс занимает около 2–3 минут. В образе уже есть всё, что нужно агенту, поэтому сервер не ставит пакеты с нуля — за счёт этого развёртывание и проходит быстро. По завершении CLI выводит две следующие команды.
Если на VPS уже есть данные, которые нужно заменить, флаг --reinstall стирает сервер и переустанавливает его из образа Office Claws. Используйте его только на сервере, который не жалко стереть.
Шаг 5: Подключите подписку Codex
officeclaws connect-codexКоманда открывает в браузере страницу входа OpenAI (или выводит ссылку). Войдите в аккаунт ChatGPT, в котором есть Codex; CLI дождётся завершения входа (до пяти минут) и подтвердит, что агент работает на вашей подписке. Codex — поддерживаемый способ подключения модели для агентов Office Claws; Claude Code и другие подписки Anthropic не поддерживаются.
Шаг 6: Начните общаться с агентом
officeclaws chatКоманда открывает интерактивный чат с основным агентом (Ctrl-D — выход). officeclaws chat -m "..." отправляет одно сообщение, --agent <id> выбирает конкретного агента, officeclaws agents выводит список агентов, а officeclaws logs --follow показывает логи агента в реальном времени.
Попробуйте эти первые сообщения, чтобы проверить настройку:
- «Чем ты можешь мне помочь?»
- «Сделай краткое изложение этого документа: [вставьте текст]»
- «Проверь этот код на ошибки: [вставьте код]»
В десктопном приложении тот же агент появляется за столом в пиксельном офисе — нажмите на его спрайт, чтобы открыть панель чата. Она хранит всю историю сообщений, так что можно продолжить разговор с того места, где вы остановились.
Что означает пиксельный офис
Если вы пользуетесь десктопным приложением, офис — это не просто визуальный эффект. Он даёт вам мгновенный обзор статуса всех ваших агентов:
- Печатает за столом — Агент активно обрабатывает запрос или доступен.
- Наливает кофе — Агент находится в коротком цикле ожидания.
- Отдыхает на диване — Агент в длительном состоянии ожидания.
- Сидит в зоне офлайн — VPS агента недоступен.
По мере добавления новых агентов каждый получает свой стол в офисе. Планировка вмещает до шести столов в основной комнате, стол в отдельном кабинете и зоны отдыха с диванами.
Как защищены ваши учётные данные
Безопасность — частый вопрос, когда инструмент получает доступ к вашим облачным и ИИ-аккаунтам. Вот как это устроено в Office Claws:
- Хранение в локальной связке ключей. API-доступ к Contabo, ключ авторизации Tailscale и сессия CLI хранятся в системной связке ключей, а не на серверах Office Claws. Секретные значения никогда не выводятся — в списках видны только замаскированные превью.
- Ваша собственная сеть. CLI и десктопное приложение подключаются к агенту по SSH через вашу сеть Tailscale. Порты SSH, HTTPS и шлюза агента открыты только внутри вашего tailnet.
- Ваша собственная подписка. Подключение Codex идёт через стандартный вход OpenAI: вы входите на странице OpenAI, и никакие API-ключи никуда не копируются. Полученная авторизация хранится на VPS вашего агента.
- Прямое соединение. Чат и логи идут напрямую между вашим компьютером и агентом через tailnet. После
officeclaws connect-codexзапросы к модели идут с VPS агента напрямую в OpenAI; до этого небольшой стартовый лимит проходит через LLM-шлюз Office Claws. Копию истории чата Office Claws хранит в вашем аккаунте; что именно хранится, перечислено на странице безопасности.
Что Office Claws автоматизирует: ручная настройка, которую вы пропускаете
Чтобы оценить развёртывание одной командой, полезно увидеть, как выглядит настройка защищённого VPS для ИИ-агента без него. Ниже — все шаги, которые Office Claws выполняет автоматически. Если делать всё самостоятельно, закладывайте от 45 минут до часа работы в терминале на каждый сервер — при условии, что каждая команда сработает с первого раза.
Создание и доступ к серверу
Вручную вам пришлось бы зайти к облачному провайдеру (Contabo, Hetzner, DigitalOcean или другому), создать сервер на Ubuntu 24.04, дождаться загрузки и подключиться по SSH как root. Также нужно сгенерировать пару SSH-ключей, загрузить публичный ключ и убедиться, что подключение работает.
Создание пользователя без прав root
Запускать сервисы от root — это угроза безопасности. Необходимо создать выделенного пользователя, добавить его в группу sudo, скопировать публичный SSH-ключ в файл authorized_keys и установить корректные права доступа (700 для каталога .ssh, 600 для файла ключа). Затем настроить доступ sudo без пароля для определённых команд — файрвол, Tailscale и Docker — чтобы процесс агента мог управлять этими сервисами без полных привилегий root.
Усиление SSH
По умолчанию SSH на свежем сервере Ubuntu разрешает вход root и аутентификацию по паролю — оба являются распространёнными векторами атак. Необходимо создать конфигурацию, которая отключает всё это:
- Вход root (
PermitRootLogin no) - Аутентификация по паролю (
PasswordAuthentication no) - Challenge-response аутентификация
- X11 forwarding
- Agent forwarding
Затем проверить синтаксис конфигурации с помощью sshd -t и перезапустить SSH-сервис. Одна опечатка в этом файле — и вы потеряете доступ к серверу.
Установка и настройка файрвола
Далее нужно установить ufw (Uncomplicated Firewall) и задать политику запрета всего входящего трафика по умолчанию. Временно разрешите SSH на всех интерфейсах, чтобы не потерять соединение, а затем — после запуска Tailscale — ограничьте SSH, HTTPS и порт шлюза агента (18789) только интерфейсом Tailscale и удалите публичное правило SSH. Итоговое состояние файрвола:
- Весь входящий трафик запрещён по умолчанию
- Порт 22 (SSH): разрешён только через Tailscale
- Порт 443 (HTTPS): разрешён только через Tailscale
- Порт 18789 (шлюз агента): разрешён только через Tailscale
- Весь исходящий трафик разрешён
Если нарушить порядок действий — ограничить SSH до того, как Tailscale заработает — вы полностью потеряете доступ к серверу.
Настройка защиты от вторжений
Установите и активируйте fail2ban, который отслеживает логи аутентификации и временно блокирует IP-адреса с признаками подбора паролей. Это добавляет уровень защиты даже в случае, если SSH окажется доступен из-за ошибки конфигурации.
Включение автоматических обновлений безопасности
Установите unattended-upgrades и apt-listchanges, затем настройте их с помощью dpkg-reconfigure. Это обеспечивает автоматическое применение патчей безопасности без ручного вмешательства. Если пропустить этот шаг, сервер перестанет получать обновления в течение нескольких недель.
Выделение подкачки (swap)
Создайте файл подкачки размером 2 ГБ в /swapfile, установите права доступа 600, отформатируйте с помощью mkswap, активируйте через swapon и добавьте запись в /etc/fstab для сохранения после перезагрузки. Без подкачки всплеск потребления памяти в процессе агента может убить контейнер или обрушить сервер.
Установка и настройка Tailscale
Установите Tailscale из официального скрипта установки, подключите его с вашим ключом авторизации и именем хоста, дождитесь назначения IP-адреса (до 60 секунд), назначьте оператора на непривилегированного пользователя, запросите TLS-сертификат и включите HTTPS-обслуживание на порту шлюза агента. Это создаёт зашифрованный туннель, заменяющий публичный интернет для всей коммуникации агента.
Установка Docker и загрузка образа агента
Установите Docker из официального скрипта, добавьте непривилегированного пользователя в группу docker, при необходимости аутентифицируйтесь в реестре контейнеров и заранее загрузите образ среды выполнения агента. Затем запустите контейнер с правильными переменными окружения, лимитами памяти (1800 МБ с 2 ГБ подкачки), сетевым режимом host, постоянным томом и политикой перезапуска для переживания перезагрузок.
Подключение провайдера модели
Настройте доступ агента к модели — API-ключ, передаваемый в контейнер через переменную окружения, или вход по подписке, как у Codex, — и настройте шлюз с поддержкой WebSocket, TLS и правами оператора. Затем дождитесь инициализации шлюза и извлеките токен аутентификации из логов контейнера.
Проверка работоспособности
Убедитесь, что правила файрвола корректны, Tailscale подключён, Docker-контейнер работает, агент отвечает через шлюз, а ваш локальный компьютер может достучаться до него через сеть Tailscale. Обновите локальный SSH-конфиг и known_hosts для удобного доступа в будущем.
Что всё это в сумме
Вот полный список компонентов и сервисов, настроенных на каждом VPS агента Office Claws:
| Компонент | Назначение |
|---|---|
ufw | Файрвол с правилами доступа только через Tailscale |
fail2ban | Защита от подбора паролей |
unattended-upgrades | Автоматические патчи безопасности |
| Конфигурация усиления SSH | Отключение входа root, паролей, проброса |
| Tailscale | Зашифрованная сеть и TLS-сертификаты |
| Docker | Контейнерная среда выполнения агента с лимитами памяти |
| 2 ГБ подкачки | Защита от переполнения памяти |
| Непривилегированный пользователь с ограниченным sudo | Принцип наименьших привилегий |
Это восемь уровней безопасности, настроенных примерно за 20 ручных шагов, каждый со своими возможными ошибками. Нарушите порядок файрвола — потеряете доступ к серверу. Забудете подкачку — агент упадёт под нагрузкой. Пропустите unattended-upgrades — сервер накопит уязвимости. Неправильно настроите SSH — оставите дверь открытой или захлопнете её перед собой.
С Office Claws вы запускаете officeclaws onboard, две-три минуты наблюдаете за прогрессом и получаете всё это — защищённое, проверенное и подключённое. Развёртывание из образа означает, что каждый сервер стартует с заранее собранного проверенного образа, поэтому нет никаких расхождений между ожидаемым и полученным результатом.
Устранение типичных проблем при настройке
«No active subscription»
Онбординг останавливается, если у аккаунта нет активной подписки. Выполните officeclaws subscribe, завершите оплату и снова запустите officeclaws onboard.
Учётные данные Contabo отклонены
Перепроверьте все четыре значения на my.contabo.com/api/details. Самая частая ошибка — ввести пароль от входа на сайт вместо API-пароля. Если вы ни разу не задавали API-пароль, сначала задайте его на этой странице.
«No VPSes found on your account»
Онбординг превращает в агента VPS, который уже есть в вашем аккаунте Contabo. Закажите VPS в Contabo, дождитесь его запуска и снова выполните officeclaws onboard.
Развёртывание идёт дольше обычного
Обычно развёртывание занимает 2–3 минуты. Если заметно дольше — возможно, Contabo ещё готовит сервер; проверьте его статус в панели управления Contabo. Запуск с --reinstall занимает больше времени, потому что Contabo сначала переустанавливает образ сервера. Если развёртывание завершилось ошибкой, CLI выведет её, officeclaws agents покажет статус агента, а полные логи лежат в ~/.openclaw/logs.
Ключ авторизации Tailscale отклонён
Убедитесь, что срок действия ключа не истёк и, если ключ одноразовый, что он ещё не использовался. Сгенерируйте новый в консоли администратора Tailscale и передайте его через officeclaws onboard --tailscale-authkey <ключ>.
Агент офлайн или чат не подключается
Убедитесь, что Tailscale запущен на вашем компьютере. chat и logs обращаются к агенту через ваш tailnet, поэтому обе стороны должны быть подключены. Откройте приложение Tailscale и проверьте, что ваше устройство отображается как «Connected».
Что дальше
Когда первый агент заработает:
- Добавьте агентов. Каждый агент получает собственный VPS и свой стол в офисе. Закажите ещё один VPS в Contabo и снова выполните
officeclaws onboard. - Настройте регулярные задачи.
officeclaws cron addсоздаёт задачи по расписанию, аofficeclaws telegram setпозволяет общаться с агентом из Telegram. - Поэкспериментируйте с персонажами агентов. Разные значения
--comm-styleдают заметно разные манеры общения.
Настройка Office Claws занимает несколько минут, а в результате вы получаете постоянное рабочее пространство с ИИ, которое продолжает работать независимо от того, открыт ли терминал или приложение. Агенты продолжают работать на своих VPS, а вы подключаетесь, когда они вам нужны.