Yougile

README

# YouGile OpenClaw Plugin

OpenClaw plugin for YouGile подключает ИИ-бота к чатам и обсуждениям задач YouGile. Плагин принимает YouGile webhook, передает сообщение в OpenClaw и отправляет ответ обратно в тот же чат.

Подходит, если нужно быстро добавить ИИ-помощника в YouGile: попросить резюме обсуждения, составить план действий или продолжить диалог по задаче.

## Установка

```bash
git clone https://github.com/yougile/yougile-openclaw-plugin.git
cd yougile-openclaw-plugin
./setup.sh
```

Если хотите заполнить настройки заранее:

```bash
cp .env.example .env
./setup.sh
```

Если `.env` уже есть, скрипт возьмет настройки из него. Если файла нет или в нем не хватает обязательных значений, скрипт спросит их и сохранит `.env` локально.

## Webhook в YouGile

После установки `setup.sh` покажет URL для webhook. Добавьте его в YouGile и подпишите на событие:

```text
chat_message-created
```

OpenClaw Gateway должен быть доступен из интернета. Путь webhook:

```text
/webhooks/yougile/<token>
```

## Как писать боту

Бот отвечает только на сообщения, которые явно адресованы ему:

```text
/openclaw сделай краткое резюме обсуждения
@Клава составь короткий план действий
```

Если в настройках указан `YOUGILE_BOT_USER_ID`, бот также понимает ответы на свои предыдущие сообщения.
В группе из двух участников, где один участник — бот, Клава может отвечать без явного упоминания.

## Контекст чатов и задач

В больших групповых чатах плагин копит неадресованные сообщения в короткий pending history buffer и добавляет их только в следующий ответ Клавы. После обработки buffer очищается, поэтому один и тот же контекст не дублируется в следующих turn.

В обсуждениях задач плагин передает компактный task context: данные задачи, `description`, первые сообщения task-чата и последние сообщения перед текущим обращением. Текущее webhook-сообщение добавляется отдельно как current message и не дублируется в task context.

Если Клаве нужна полная история, она должна дочитать её через YouGile REST API v2 (`GET /tasks/<taskId>` и `GET /chats/<taskId>/messages`).

## Что делает `setup.sh`

- Создает или читает локальный `.env`.
- Устанавливает OpenClaw, если команда `openclaw` не найдена.
- Устанавливает и включает плагин `yougile`.
- Прописывает настройки канала YouGile в конфигурацию OpenClaw.
- Показывает URL, который нужно указать в webhook YouGile.

## Ограничения

Сейчас поддерживаются текстовые сообщения в личных и групповых чатах YouGile. Медиафайлы и документы не обрабатываются.