Как настроить Office Claws: полное пошаговое руководство

Как настроить Office Claws: полное пошаговое руководство — Настройте Office Claws и разверните защищённого ИИ-агента на своём VPS в Contabo за несколько минут: установка CLI, подписка, учётные данные Contabo и Tailscale, развёртывание, подключение Codex и автоматическая защита.
15 апр. 2026 г.12 мин чтения
Share with
Содержание

Управление ИИ-агентами обычно означает борьбу с окнами терминала, 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.

Бесплатного пробного периода нет — для развёртывания нужна активная подписка. Возвраты регулируются нашей Политикой возврата.

Setup flow: Download, Register, Configure, Provision, Chat

Шаг 1: Установите CLI

Установите CLI officeclaws одной командой:

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

Выполните officeclaws version, чтобы убедиться, что он доступен в PATH. Предпочитаете графический интерфейс? Десктопное приложение с пиксельным офисом доступно на главной странице и работает с тем же аккаунтом и теми же агентами.

Шаг 2: Создайте аккаунт и оформите подписку

officeclaws register    # или: officeclaws login
officeclaws subscribe

register создаёт аккаунт Office Claws по email и паролю; если аккаунт уже есть, используйте login. subscribe открывает страницу оплаты в браузере (если браузер открыть не удалось, команда выведет ссылку). Как только оплата пройдёт, аккаунт готов к развёртыванию агентов.

Шаг 3: Пройдите онбординг первого агента

officeclaws onboard --name Mona

Онбординг интерактивный. Он:

  1. Проверяет, что подписка активна. Если нет — отправляет вас к officeclaws subscribe.
  2. Запрашивает четыре параметра API-доступа к Contabo и проверяет их. Они сохраняются в системной связке ключей, так что вводить их нужно только один раз.
  3. Запрашивает ключ авторизации Tailscale — он тоже сохраняется в связке ключей.
  4. Создаёт SSH-ключ, с помощью которого CLI подключается к вашим агентам.
  5. Синхронизирует список VPS в вашем аккаунте Contabo и предлагает выбрать тот, который станет агентом.

Если не указать --name, онбординг спросит имя. Два необязательных флага персонализируют агента: --comm-style friendly|business|creative задаёт тон общения, а --avatar выбирает один из 12 пиксельных аватаров для офиса в десктопном приложении. Для каждого вопроса есть и флаг (--contabo-client-id, --tailscale-authkey, --vps и т. д.), поэтому онбординг можно запустить полностью неинтерактивно — officeclaws help покажет их все.

Шаг 4: Следите за развёртыванием

После выбора VPS Office Claws разворачивает его и выводит прогресс прямо в терминал:

  1. Устанавливает агента из готового образа Office Claws.
  2. Подключает VPS к вашей сети Tailscale.
  3. Усиливает защиту сервера и запускает среду агента в Docker.
  4. Настраивает шлюз агента, доступный только через ваш 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:

  1. Хранение в локальной связке ключей. API-доступ к Contabo, ключ авторизации Tailscale и сессия CLI хранятся в системной связке ключей, а не на серверах Office Claws. Секретные значения никогда не выводятся — в списках видны только замаскированные превью.
  2. Ваша собственная сеть. CLI и десктопное приложение подключаются к агенту по SSH через вашу сеть Tailscale. Порты SSH, HTTPS и шлюза агента открыты только внутри вашего tailnet.
  3. Ваша собственная подписка. Подключение Codex идёт через стандартный вход OpenAI: вы входите на странице OpenAI, и никакие API-ключи никуда не копируются. Полученная авторизация хранится на VPS вашего агента.
  4. Прямое соединение. Чат и логи идут напрямую между вашим компьютером и агентом через 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:

All 8 security layers automated by 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, а вы подключаетесь, когда они вам нужны.

Автор

Office Claws Team

Создаём будущее управления ИИ-агентами в Office Claws. Делимся опытом в области инфраструктуры, безопасности и удобства разработки.

Запустите первого агента примерно за 3 минуты

Установите CLI Office Claws, подключите аккаунт Contabo и подписку Codex — агент получит собственный VPS и рабочее место в офисе.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/мес + ваш собственный VPS в Contabo · ключи остаются в вашей связке ключей