Полное руководство по установке ИИ-ассистента Clawdbot на macOS, Linux и Windows. Быстрая установка одной командой или варианты ручной настройки.

Обзор установки Clawdbot

Используйте установщик Clawdbot, если у вас нет особых причин этого не делать. Он настраивает CLI и автоматически запускает процесс начальной настройки.

Быстрая установка (Рекомендуется)

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

curl -fsSL https://clawd.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://clawd.bot/install.ps1 | iex

Следующий шаг (если вы пропустили начальную настройку):

clawdbot onboard --install-daemon

Системные требования

Требование	Детали
Node.js	Версия 22 или выше
Операционная система	macOS, Linux или Windows через WSL2
pnpm	Требуется только при сборке из исходного кода

Выберите способ установки

1. Скрипт установки (Рекомендуется)

Установщик Clawdbot устанавливает глобально через npm и запускает начальную настройку:

curl -fsSL https://clawd.bot/install.sh | bash

Параметры установщика:

curl -fsSL https://clawd.bot/install.sh | bash -s -- --help

Неинтерактивный режим (пропустить начальную настройку):

curl -fsSL https://clawd.bot/install.sh | bash -s -- --no-onboard

2. Глобальная установка (Вручную)

Если у вас уже установлен Node.js:

npm install -g clawdbot@latest

Если у вас глобально установлен libvips и sharp не работает:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g clawdbot@latest

С pnpm:

pnpm add -g clawdbot@latest
pnpm approve-builds -g  # одобрить clawdbot, node-llama-cpp, sharp и др.

Затем запустите начальную настройку:

clawdbot onboard --install-daemon

3. Из исходного кода (Для разработчиков)

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

4. Другие варианты установки

Docker: См. Установка Docker
Nix: См. Установка Nix
Ansible: См. Установка Ansible

После установки

Выполните эти команды для проверки установки Clawdbot:

# Запустить начальную настройку
clawdbot onboard --install-daemon

# Быстрая проверка
clawdbot doctor

# Проверить состояние шлюза
clawdbot status
clawdbot health

# Открыть панель управления
clawdbot dashboard

Метод установки: npm vs git

Установщик Clawdbot поддерживает два метода:

Метод	Описание
`npm` (по умолчанию)	`npm install -g clawdbot@latest`
`git`	Клонировать/собрать из исходного кода GitHub

Параметры CLI:

# Явный npm
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method npm

# Установка из GitHub (checkout исходного кода)
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method git

Общие параметры:

Параметр	Описание
`--install-method npm\|git`	Выбрать метод установки
`--git-dir <path>`	Каталог Git (по умолчанию: ~/clawdbot)
`--no-git-update`	Пропустить git pull для существующего checkout
`--no-prompt`	Отключить запросы (для CI/автоматизации)
`--dry-run`	Показать, что произойдёт
`--no-onboard`	Пропустить начальную настройку

Переменные окружения

Для автоматизации используйте эти переменные окружения:

CLAWDBOT_INSTALL_METHOD=git|npm
CLAWDBOT_GIT_DIR=...
CLAWDBOT_GIT_UPDATE=0|1
CLAWDBOT_NO_PROMPT=1
CLAWDBOT_DRY_RUN=1
CLAWDBOT_NO_ONBOARD=1
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1

Устранение неполадок: clawdbot не найден (PATH)

Быстрая диагностика:

node -v
npm -v
npm prefix -g
echo "$PATH"

Если $(npm prefix -g)/bin отсутствует в вашем PATH, добавьте его в файл запуска оболочки:

macOS / Linux (~/.zshrc или ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Windows: Добавьте вывод npm prefix -g в переменную окружения PATH.

Затем откройте новый терминал или выполните hash -r (bash) / rehash (zsh).

Обновление / Удаление

Обновления: См. Обновление Clawdbot
Удаление: См. Удаление Clawdbot

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

Руководство по настройке Clawdbot - Полное руководство по настройке
Шлюз Clawdbot - Настройка шлюза
Clawdbot WhatsApp - Подключение к WhatsApp

Руководство по установке Clawdbot