Настройка Clawdbot на Windows (WSL2)

Запустите ИИ-ассистента Clawdbot на Windows с помощью WSL2. Полноценный Linux-опыт с Ubuntu для согласованной среды выполнения и совместимости инструментов.

Обзор Clawdbot на Windows

Clawdbot на Windows рекомендуется использовать через WSL2 (рекомендуется Ubuntu). CLI + Gateway работают внутри Linux, что обеспечивает согласованность среды выполнения и значительно улучшает совместимость инструментов.

Нативный Windows может быть сложнее. WSL2 даёт вам полноценный Linux-опыт — одна команда для установки: wsl --install.

Нативные приложения-компаньоны для Windows запланированы.

Установка (WSL2)

Шаг 1: Установить WSL2 + Ubuntu

Откройте PowerShell (Администратор):

wsl --install
# Или явно выберите дистрибутив:
wsl --list --online
wsl --install -d Ubuntu-24.04

Перезагрузите компьютер, если Windows попросит.

Шаг 2: Включить systemd (Обязательно)

В вашем терминале WSL:

sudo tee /etc/wsl.conf > /dev/null << 'EOF'
[boot]
systemd=true
EOF

Затем из PowerShell:

wsl --shutdown

Снова откройте Ubuntu и проверьте:

systemctl --user status

Шаг 3: Установить Clawdbot (Внутри WSL)

Следуйте инструкции по началу работы с Linux внутри WSL:

# Вариант 1: Быстрая установка
curl -fsSL https://clawd.bot/install.sh | bash

# Вариант 2: Из исходного кода
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

Установка службы Gateway (CLI)

Внутри WSL2:

# Вариант 1
clawdbot onboard --install-daemon

# Вариант 2
clawdbot gateway install

# Вариант 3
clawdbot configure
# Выберите "Gateway service" при запросе

Восстановление/миграция:

clawdbot doctor

Доступ к службам WSL через LAN (Продвинутый уровень)

У WSL своя виртуальная сеть. Если другой машине нужен доступ к службе, работающей внутри WSL, необходимо перенаправить порт Windows на текущий IP WSL.

Примечание: IP WSL меняется после перезагрузки, поэтому может потребоваться обновить правило перенаправления.

Пример (PowerShell от имени Администратора)

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]

if (-not $WslIp) { throw "WSL IP not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
    connectaddress=$WslIp connectport=$TargetPort

Разрешить в брандмауэре (Однократно)

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
    -Protocol TCP -LocalPort $ListenPort -Action Allow

Обновление после перезапуска WSL

netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
    connectaddress=$WslIp connectport=$TargetPort | Out-Null

Примечания:

  • SSH с другой машины направляется на IP хоста Windows (например, ssh user@windows-host -p 2222)
  • Используйте listenaddress=0.0.0.0 для доступа по LAN; 127.0.0.1 — только локальный доступ
  • Для автоматического обновления создайте Запланированную задачу, выполняемую при входе в систему

Настройка Gateway

Смотрите основные руководства:

Проверки работоспособности

clawdbot status
clawdbot health
clawdbot doctor

Приложение-компаньон для Windows

У нас пока нет приложения-компаньона для Windows. Вклады приветствуются.

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