Что такое OfficeAgent и чем он отличается от обычного бота на ChatGPT?

Это не обёртка над чужим API-сервером, а self-hosted харнесс: бот живёт на вашем VPS, обращается напрямую к вашему аккаунту Claude, данные не проходят через сторонние сервисы. Плюс полноценная сессия Claude Code — файлы, bash, MCP-инструменты, а не просто чат.

Нужно ли уметь программировать, чтобы поставить OfficeAgent?

Установка — одна команда (sudo bash install.sh), дальше установщик задаёт вопросы по очереди и сам ставит зависимости. Понадобится только умение подключиться по SSH и скопировать несколько токенов из чужих кабинетов — писать код не нужно.

От чего зависит стоимость — сервер плюс Claude?

Две отдельные статьи расходов: аренда VPS (план от 4 ГБ RAM — минимум, чтобы память бота не упёрлась в своп при старте) и доступ к Claude — либо готовая подписка Pro/Max, либо API-ключ с оплатой по факту использования. Точная сумма зависит от провайдера VPS и выбранного тарифа Claude — оба варианта закрывает виртуальная карта из гайда про CardsPro.

Можно ли использовать GLM вместо Claude, чтобы сэкономить?

Да, GLM (Z.ai) подключается как альтернативная модель на этапе установки или позже, дешевле Claude. Между Claude и GLM можно переключаться прямо в чате командой /model, ничего не переустанавливая.

Что бот не сможет сделать, даже если нажать «подтвердить»?

По-настоящему разрушительные операции — удаление системных данных, форматирование дисков — заблокированы безусловно на уровне кода, никакая кнопка подтверждения их не пропустит. Кнопка подтверждения нужна только для рискованных, но легитимных действий вроде перезапуска сервиса.

Как поставить своего AI-агента (OfficeAgent) — от пустого сервера до бота в Telegram

OfficeAgent — self-hosted AI-агент: бот в Telegram, который живёт на вашем собственном сервере и работает через ваш собственный аккаунт Claude, без посредников между вами и Anthropic. Пишете боту напрямую — он читает файлы, выполняет команды в терминале, пользуется MCP-инструментами прямо внутри диалога. Ниже — весь путь от пустого сервера до рабочего бота.

Это тот же принцип, на котором я сам держу свой цифровой офис — просто упакованный так, чтобы поставить копию себе можно было одной командой, без переизобретения инфраструктуры с нуля. Чем это вообще отличается от обычного чата с Claude — отдельно разобрал в статье про агента, который работает 24/7 на своём сервере.

Что нужно подготовить

Обязательно:

сервер (VPS) с чистым Ubuntu и root-доступом по SSH;
способ оплаты зарубежных сервисов — виртуальная карта (гайд про CardsPro);
токен Telegram-бота от @BotFather;
свой числовой Telegram ID от @userinfobot;
доступ к Claude — подписка или API-ключ Anthropic.

Опционально, можно пропустить при установке и добавить позже:

токен GLM/Z.ai — альтернативная модель, дешевле;
ключ Groq — распознавание голосовых сообщений;
супергруппа в Telegram с топиками — для командной работы.

Шаг 1. Арендуем сервер

Подойдёт любой VPS-провайдер с root-доступом к чистому Ubuntu (лучше 24.04 LTS). Регистрация, привязка способа оплаты, создание сервера с образом Ubuntu 24.04 (LTS) x64, регион — любой, ближе к вам или к аудитории бота.

Провайдер	Цена от	Что за неё	Особенность
DigitalOcean	$6/мес	1 vCPU, 1 ГБ RAM	самый developer-friendly, удобная консоль
Vultr	$6/мес	1 vCPU, 1 ГБ RAM	много дата-центров, бонус $300 новым
Hetzner	€3.79/мес	2 vCPU, 4 ГБ RAM	лучшая цена/мощность в Европе
Linode (Akamai)	$5/мес	1 ГБ RAM	давно на рынке, надёжная поддержка
Contabo	€4.99/мес	4 vCPU, 6 ГБ RAM	мощнее всех за эти деньги, поддержка медленная
TimeWeb Cloud	250 ₽/мес	—	российский, сервера в РФ и ЕС, платится рублями напрямую — карта из шага 2 не нужна

TimeWeb — единственный из списка, где сервер оплачивается рублями напрямую, без виртуальной карты. Но это только про сам сервер: подписку или API-ключ Claude всё равно придётся оплачивать иностранной картой (шаг 2) вне зависимости от того, где физически стоит VPS.

Аутентификация — SSH-ключ (надёжнее) или пароль root. После создания сервера получаете доступ: IP-адрес (четыре числа через точку, например 185.23.14.201) и пароль root — на почту или сразу на экране.

Подключаетесь к терминалу сервера: на Windows — приложение «Терминал» или PowerShell, на Mac/Linux — «Терминал», команда одна и та же — ssh root@ваш_IP, Enter, на вопрос про fingerprint — yes, дальше пароль (при вводе он не отображается на экране — это нормально). Если никогда не открывали терминал раньше — этого достаточно, дальше просто печатаете команды из шагов ниже и жмёте Enter.

Шаг 2. Оплата зарубежных сервисов

Понадобится виртуальная карта — оплатить и аренду сервера, и подписку Claude/OpenAI. Полный процесс (регистрация, KYC, выбор BIN под конкретный сервис) — в отдельном гайде про CardsPro. Если для регистрации на самих сервисах нужен ещё и не-российский Google/Apple-аккаунт — это соседний гайд.

Шаг 3. Токен Telegram-бота

В Telegram находите @BotFather (официальный, с синей галочкой), отправляете /newbot, придумываете имя и username (должен заканчиваться на bot, например my_office_agent_bot). BotFather пришлёт токен вида 123456789:AAH... — сохраните его и никому не показывайте, им можно полностью управлять ботом.

Шаг 4. Узнаём свой Telegram ID

Находите @userinfobot, пишете ему что угодно (например /start) — он пришлёт в ответ числовой ID (например 448238861). Он понадобится при установке — это то, что делает вас единственным владельцем бота.

Шаг 5. Супергруппа с топиками (опционально)

Нужно, если хотите, чтобы бот работал не только в личке, а в общей группе с отдельными топиками под разные задачи.

Создайте обычную группу, добавьте туда бота как участника по username.
В настройках группы включите «Тема» / Topics — группа автоматически станет супергруппой.
Создайте хотя бы один топик, откройте его, скопируйте ссылку на любое сообщение внутри — она будет выглядеть как https://t.me/c/1234567890/5.
Число после /c/ — внутренний ID группы. Настоящий chat_id для Bot API = -100 + это число. Установщик сам добавит -100, если вставить просто число из ссылки.

Шаг 6. Доступ к Claude

Два варианта — выбираете один.

А. По подписке Claude (Pro/Max) — не тратится на отдельные запросы: на своём компьютере (не на сервере) ставите Claude Code (npm i -g @anthropic-ai/claude-code), выполняете claude — откроется браузер, входите тем же аккаунтом, что и в приложении Claude. Затем claude setup-token — подтверждаете в браузере, копируете токен из терминала. Этот же токен установщик умеет сгенерировать прямо во время установки (см. шаг 9).

Б. По API-ключу Anthropic — платите за фактическое использование: регистрация на console.anthropic.com, привязка карты (см. шаг 2), создание ключа в Settings → API Keys — он начинается с sk-ant-.

Шаг 7. GLM/Z.ai (опционально)

Дешевле Claude, можно использовать вместо него или как запасной вариант: регистрация на z.ai, токен из личного кабинета.

Шаг 8. Groq для голосовых сообщений (опционально)

Без этого ключа бот понимает только текст. Регистрация на console.groq.com, создание API-ключа.

Шаг 9. Запускаем установку

Подключаетесь по SSH к серверу и выполняете:

apt update && apt install -y git
git clone https://github.com/a-prs/OfficeAgent.git
cd OfficeAgent
sudo bash install.sh

Установщик задаёт вопросы по очереди:

Вопрос	Что вводить
Telegram bot token	токен из шага 3
Your Telegram numeric user id	ID из шага 4
Claude auth — ANTHROPIC_API_KEY или пусто	ключ из шага 6Б, либо Enter, если выбрали подписку (6А)
Already have a CLAUDE_CODE_OAUTH_TOKEN?	`y`, если токен уже сгенерирован по 6А заранее; `n` — установщик сам запустит `claude setup-token` и подскажет ссылку для подтверждения с любого устройства
Full-text search language	Enter, не влияет
Also connect GLM (Z.ai)?	`y` + токен из шага 7, либо Enter/`n`
Groq API key	ключ из шага 8, либо Enter, чтобы пропустить
Also connect a Telegram supergroup?	chat_id из шага 5, либо Enter, чтобы пропустить

Дальше установщик всё делает сам — 2-5 минут: ставит зависимости, настраивает систему, поднимает сервисы. В конце пишет Install complete.

Шаг 10. Проверка

Пишете своему боту в Telegram что угодно, например «Тут?» — он должен ответить. При первом запуске может отвечать чуть дольше обычного, статус «печатает» покажет, что процесс идёт.

Что умеет бот

Встроенные команды:

/tutorial — интерактивное меню прямо в боте: что умеет, как писать, какие права, частые вопросы;
/model alt|primary — переключить модель (Claude ↔ GLM), можно и кнопками без аргументов;
/stop — остановить текущую задачу;
/restart — перезапустить сессию с чистого листа;
/reset force — сбросить состояние сессии, с явным подтверждением;
/status — снимок состояния бота и текущей сессии;
/help — встроенная справка Claude Code.

Обычные запросы текстом или голосом: «покажи логи сервиса X за последний час», «перезапусти сервис Y», «проверь, сколько места на диске», «объясни, что делает этот файл» (можно приложить файл), «напиши скрипт, который…», «что изменилось в проекте за последнюю неделю?».

Бот помнит контекст между сессиями (память gbrain — recall работает как «мы это уже обсуждали?»), понимает голосовые сообщения при подключённом Groq-ключе, а для рискованных действий вроде перезапуска системных сервисов присылает кнопку подтверждения в личку — без явного тапа ничего не выполнится.