Справочник CLI
Все команды и флаги officeclaws в одном месте.
Выполните officeclaws help, чтобы увидеть встроенную краткую справку. Большинство команд, работающих с агентом, принимают --agent <id>. Без этого флага они используют вашего первого агента.
Аккаунт
| Команда | Описание |
|---|---|
officeclaws register [--email] [--name] [--password-stdin] | Создать аккаунт и войти |
officeclaws login [--email] [--password-stdin] | Войти |
officeclaws logout [--keep-credentials] | Выйти. Также удаляет сохраненные учетные данные, если не передан --keep-credentials. |
officeclaws whoami | Показать текущий аккаунт и есть ли у него агент |
officeclaws subscribe [--plan selfHosted] [--locale en] | Открыть страницу оплаты, привязанную к вашему аккаунту |
--password-stdin читает пароль из стандартного ввода — для скриптов. Пример: echo "$PW" | officeclaws login --email [email protected] --password-stdin.
Агенты
| Команда | Описание |
|---|---|
officeclaws onboard [flags] | Настроить VPS в Contabo как агента. См. Создание агента. |
officeclaws agents | Список ваших агентов |
officeclaws connect-codex [--agent] | Подключить подписку ChatGPT |
officeclaws chat [--agent] [-m "message"] | Интерактивный чат или отправка одного сообщения |
officeclaws logs [--agent] [--lines N] [-f] | Показать логи агента или следить за ними в реальном времени |
Флаги onboard: --name, --vps, --reinstall, --ssh-pubkey, --avatar, --comm-style, --tailscale-hostname, --tailscale-authkey, --contabo-client-id, --contabo-client-secret, --contabo-api-user, --contabo-api-password. --reinstall предназначен для наших внутренних готовых образов серверов и не стирает ваш VPS. Чтобы начать с чистого сервера, переустановите Ubuntu 24.04 из панели управления Contabo.
Задачи по расписанию
| Команда | Описание |
|---|---|
officeclaws cron list | Список задач по расписанию |
officeclaws cron add --name --schedule --message [--timezone] [--channel] [--target] | Добавить задачу |
officeclaws cron rm <name-or-id> | Удалить задачу |
Telegram
| Команда | Описание |
|---|---|
officeclaws telegram set [--bot-token] [--dm-policy pairing|allowlist|open|disabled] | Подключить или обновить бота |
officeclaws telegram show | Показать текущие настройки |
officeclaws telegram pairings | Список ожидающих кодов привязки |
officeclaws telegram approve <code> | Одобрить пользователя Telegram |
officeclaws telegram disable | Отключить Telegram |
Учетные данные и устройства
| Команда | Описание |
|---|---|
officeclaws vault list [--type contabo|tailscale|telegram] | Список сохраненных учетных данных (значения скрыты) |
officeclaws vault apply <id> | Сделать сохраненный набор активным |
officeclaws vault rm <id> | Удалить сохраненный набор |
officeclaws devices list / approve <id> | Запросы устройств на шлюзе агента |
officeclaws pairing list / approve <id> / reject <id> / repair | Запросы привязки оператора; repair исправляет ошибку «1008 pairing required» |
Дополнительно
| Команда | Описание |
|---|---|
officeclaws adopt --vps <id> --host <tailscale-ip> --name <name> | Зарегистрировать уже работающего агента, если настройка прервалась после того, как сервер был готов. Используйте только по просьбе поддержки. |
officeclaws version | Вывести версию |
Переменные окружения
| Переменная | Описание |
|---|---|
OFFICECLAWS_DEBUG=1 | Выводить подробные логи в stderr |
OPENCLAW_RPC=0 | Использовать резервное подключение чата (нужно редко) |
Где что хранится
| Что | Где |
|---|---|
| Сессия, учетные данные Contabo и Tailscale, vault | Системное хранилище ключей, сервис openclaw-office |
| SSH-ключ для управления агентами | ~/.ssh/openclaw_id_ed25519 |
| Логи настройки | ~/.openclaw/logs |