Настройка приложения macOS

Обзор

Это руководство описывает опыт первоначальной настройки приложения Clawdbot для macOS, охватывая процесс от первого запуска до инициализации агента.

Процесс настройки

Настройка включает 8 шагов:

Шаг 1: Приветствие

Начальный экран приветствия с уведомлением о безопасности касательно возможностей Clawdbot.

Шаг 2: Выбор шлюза

Выберите режим шлюза:

Шаг 3: Аутентификация

Для локальных настроек выполните аутентификацию у вашего ИИ-провайдера:

• Anthropic OAuth - Для подписчиков Claude Pro/Max
• Anthropic API Key - Прямой доступ к API
• OpenAI - Модели GPT
• Другие провайдеры - Различные варианты

Процесс OAuth открывает браузер для PKCE-аутентификации. Вставьте значение кода/состояния по запросу.

Учётные данные хранятся в: ~/.clawdbot/credentials/oauth.json

Шаг 4: Мастер настройки

Конфигурация под управлением шлюза для:

• Настроек порта и сети
• Интеграций каналов
• Установки навыков

Шаг 5: Разрешения

macOS требует явного предоставления разрешений:

Предоставляйте разрешения по запросу. Некоторые функции требуют определённых разрешений для работы.

Шаг 6: Установка CLI

Опциональная установка глобальной команды clawdbot:

# Установлено в /usr/local/bin/clawdbot
clawdbot --version

Шаг 7: Чат знакомства

Выделенная сессия для представления агента:

• Агент создаёт рабочее пространство (~/.clawdbot/workspace)
• Инициализирует файлы: AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md
• Проводит опрос для персонализации вашего опыта
• Узнаёт ваши предпочтения и сценарии использования

Шаг 8: Готово

Настройка завершена. Теперь вы можете:

• Общаться с вашим ассистентом
• Настроить дополнительные каналы
• Установить навыки
• Настроить рабочее пространство

Режимы шлюза

Локальный режим

• Шлюз работает на вашем Mac
• OAuth-процессы работают напрямую
• Учётные данные хранятся локально
• Лучше всего для личного использования

Удалённый режим

При использовании удалённого шлюза:

• Все учётные данные находятся на хосте шлюза
• Файлы рабочего пространства на удалённой машине
• Локальный Mac работает только как клиент
• Полезно для общих или серверных развёртываний

Инициализация агента

При первом запуске агент:

1. Создаёт директорию рабочего пространства
2. Инициализирует файлы инструкций
3. Проводит персонализационный опрос
4. Настраивает начальные предпочтения

Файлы инициализации

Устранение неполадок

Проблемы с разрешениями

Если функции не работают:

1. Откройте Системные настройки → Конфиденциальность и безопасность
2. Проверьте каждую категорию разрешений
3. Убедитесь, что Clawdbot включён
4. Перезапустите приложение при необходимости

Ошибки OAuth

Если аутентификация не удаётся:

1. Проверьте подключение к интернету
2. Подтвердите статус подписки
3. Попробуйте ввести API-ключ вручную
4. Проверьте ~/.clawdbot/credentials/ на наличие проблем

Шлюз не запускается

1. Проверьте, доступен ли порт 18789
2. Просмотрите логи в /tmp/clawdbot/
3. Попробуйте clawdbot health из терминала

Следующие шаги

• Руководство по настройке - Подробная конфигурация
• Создание ассистента - Создайте своего ассистента
• Каналы - Подключение платформ обмена сообщениями