<div align="center">

# QwenPaw

[![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-black.svg?logo=github)](https://github.com/agentscope-ai/QwenPaw)
[![PyPI](https://img.shields.io/pypi/v/qwenpaw?color=3775A9&label=PyPI&logo=pypi)](https://pypi.org/project/qwenpaw/)
[![Documentation](https://img.shields.io/badge/Docs-Website-green.svg?logo=readthedocs&label=Docs)](https://qwenpaw.agentscope.io/)
[![Python Version](https://img.shields.io/badge/python-3.11%20~%20%3C3.14-blue.svg?logo=python&label=Python)](https://www.python.org/downloads/)
[![Last Commit](https://img.shields.io/github/last-commit/agentscope-ai/QwenPaw)](https://github.com/agentscope-ai/QwenPaw)
[![License](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache&label=License)](LICENSE)
[![Code Style](https://img.shields.io/badge/code%20style-black-black.svg?logo=python&label=CodeStyle)](https://github.com/psf/black)
[![GitHub Stars](https://img.shields.io/github/stars/agentscope-ai/QwenPaw?style=flat&logo=github&color=yellow&label=Stars)](https://github.com/agentscope-ai/QwenPaw/stargazers)
[![GitHub Forks](https://img.shields.io/github/forks/agentscope-ai/QwenPaw?style=flat&logo=github&color=purple&label=Forks)](https://github.com/agentscope-ai/QwenPaw/network)
[![DeepWiki](https://img.shields.io/badge/DeepWiki-Ask_Devin-navy.svg?logo=data:image/png;base64, )](https://deepwiki.com/agentscope-ai/QwenPaw)
[![Discord](https://img.shields.io/badge/Discord-Join_Us-blueviolet.svg?logo=discord)](https://discord.gg/eYMpfnkG8h)
[![X](https://img.shields.io/badge/X-Follow_Us-black.svg?logo=x)](https://x.com/agentscope_ai)
[![DingTalk](https://img.shields.io/badge/DingTalk-Join_Us-orange.svg)](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11)
[![AgentScope Platform](https://img.shields.io/badge/%E2%98%81_AgentScope_Platform-%F0%9F%90%BE_7%2F24_Online_%26_Free-FF6B2B.svg)](https://platform.agentscope.io/)

<a href="https://trendshift.io/repositories/25882" target="_blank"><img src="https://trendshift.io/api/badge/trendshift/repositories/25882/daily" alt="agentscope-ai%2FQwenPaw | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

[[Документация](https://qwenpaw.agentscope.io/)] [[English](README.md)] [[中文](README_zh.md)] [[日本語](README_ja.md)]

<p align="center">
  <img src="https://gw.alicdn.com/imgextra/i1/O1CN01sens5C1TuwioeGexL_!!6000000002443-55-tps-771-132.svg" alt="QwenPaw Logo" width="120">
</p>

<p align="center"><b>Понимает вас, всегда с вами.</b></p>

</div>

Ваш персональный AI-ассистент — разверните локально или в облаке, расширяйте с помощью Skills и Plugins, подключайтесь через любые каналы.

| | |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Никогда не забывает**                   | Трёхуровневая память — рабочий контекст в реальном времени, полная дословная история и дистиллированные знания. Старые реплики вытесняются, но доступны по запросу; ничего не суммируется и не теряется.     |
| **Локально или в облаке, бесплатно**      | Модели QwenPaw-Flash (2B / 4B / 9B), обученные для агентных задач. Встроенный рантайм QwenPaw Local — без API-ключа, без зависимости от облака. Также работает с Ollama, LM Studio и 14+ облачными провайдерами.   |
| **Безопасность из коробки**               | Песочница на уровне ядра, Tool Guard, File Guard и Skill Scanner. Опасные команды блокируются до выполнения.                                            |
| **Мультиагентность и параллелизм**        | Создавайте независимых агентов со своей памятью и навыками. Субагенты во время выполнения. Agent Communication Protocol (ACP) для кросс-системной оркестрации.                               |
| **Coding Mode**                           | Трёхпанельная Web IDE с деревом файлов, предпросмотром diff и чатом. Переход к определению, поиск ссылок и структурный поиск по коду встроены.                                              |
| **Расширяемость**                         | Skills для планирования, документов, браузера, новостей и многого другого. Архитектура плагинов с маркетплейсом. Интеграция MCP для внешних инструментов. Комбинируйте в целевые рабочие процессы.  |
| **Доступен везде**                        | DingTalk, Lark, WeChat, Discord, Telegram, iMessage, QQ — один экземпляр, все каналы. Console, TUI и десктопное приложение для прямого доступа.                                            |
| **Ваш, не наш**                           | Развертывание локально — данные остаются на вашей машине. Без стороннего хостинга, без загрузки данных.                                                                         |

> <details>
> <summary><b>Что можно делать с QwenPaw</b></summary>
>
> <br>
>
> - **Автоматизация и планирование**: Настройте повторяющиеся задачи — дайджесты новостей, генерация отчётов, мультиканальная рассылка — всё по вашему расписанию.
> - **Код и разработка**: Читайте, редактируйте, проверяйте и тестируйте код в проектах; Coding Mode помогает быстро находить и понимать код.
> - **Обработка документов**: Чтение, запись и преобразование PDF, Word, Excel и PowerPoint.
> - **Сбор информации**: Поиск в интернете, отслеживание подписок, суммаризация видео и поиск в персональной базе знаний.
> - **Мультиканальные операции**: Отправка оповещений, дайджестов или AI-контента в DingTalk, Lark, Discord, Telegram и другие — одновременно или по каналам.
> - **Пользовательские сценарии**: Объединяйте встроенные возможности, плагины и запланированные задачи в сценарии под ваши задачи.
>
> </details>

---

## Новости

- [2026-07-24] **v2.0.1** | Платформа мини-приложений PawApp, редактируемые Agent Mode, Oh-My-Paw plugins, улучшения памяти ReMe, улучшения UX десктопа и др. [v2.0.1 Release Notes →](https://qwenpaw.agentscope.io/release-notes#v2.0.1)

- [2026-07-10] **v2.0.0 — QwenPaw 2.0 Official Release** 🎉 | Полностью переписанный на основе AgentScope 2.0: архитектура Agent OS, Loop Engineering, Scroll Context, ReMe v0.4.0 Long-term Memory и встроенный TUI.

  | Основное | Что нового |
  |----------|-----------|
  | **Agent OS — Workspace** | Три столпа на агента: **Resources** (прозрачно на диске), **Governance** (allow/deny/ask/sandbox), **Sandbox** (macOS / Linux / Windows). |
  | **Agent OS — Drivers** | Протокол-нейтральный слой коннекторов MCP / A2A / ACP с шифрованием учётных данных и политикой на вызов. |
  | **Loop Engineering** | Продвинутые шаблоны циклов агента (Coding Mode, Mission Mode, далее — больше) с компонуемыми вентилями одобрения. |
  | **Scroll Context** | Каждый ход сохраняется; вытесненные ходы индексируются с recall по запросу — ничего не суммаризуется. |
  | **ReMe v0.4.0 Long-term Memory** | Авто-трекинг по ходам, поиск с учётом использования, бэкенд-специфичные эмбеддинги. |
  | **Terminal UI (TUI)** | Полноэкранный терминальный чат — тот же агент, память и сессии, что в Console и каналах. |

  На базе Agent OS мы будем выпускать готовые к использованию приложения QwenPaw — такие как **QwenPaw Creator** и **QwenPaw Insight** — следите за обновлениями. [v2.0.0 Release Notes →](https://qwenpaw.agentscope.io/release-notes#v2.0.0)

- [2026-06-17] **v1.1.12 — Обновление страницы моделей и Простой режим** | Новый дизайн страницы моделей с агрегацией провайдеров; Простой режим для упрощённой навигации. [v1.1.12 Release Notes →](https://qwenpaw.agentscope.io/release-notes#v1.1.12)

- [2026-06-11] **Запуск платформы AgentScope** — Бесплатный деплой QwenPaw, обмен плагинами и маркет Skill. [Попробовать →](https://platform.agentscope.io/)

- [2026-06-10] **v1.1.11** — Бесплатные модели OAuth, Маркет плагинов, Белый список MCP. [v1.1.11 Release Notes →](https://qwenpaw.agentscope.io/release-notes#v1.1.11)

[Все release notes →](https://qwenpaw.agentscope.io/release-notes)

---

## Оглавление

- [Новости](#новости)
- [Быстрый старт](#быстрый-старт)
- [API Key](#api-key)
- [Локальные модели](#локальные-модели)
- [Функции безопасности](#функции-безопасности)
- [Документация](#документация)
- [FAQ](#faq)
- [Дорожная карта](#дорожная-карта)
- [Участие в проекте](#участие-в-проекте)
- [Установка из исходников](#установка-из-исходников)
- [Почему QwenPaw?](#почему-qwenpaw)
- [Кто разрабатывает](#кто-разрабатывает)
- [Лицензия](#лицензия)

---

## Быстрый старт

### Вариант 1: Pip Install

Если вы предпочитаете самостоятельно управлять Python (требуется Python >= 3.11, < 3.14):

```bash
pip install qwenpaw
qwenpaw init --defaults
qwenpaw app
```

Затем откройте консоль в браузере: **http://127.0.0.1:8088/** и настройте модель. Для чата в DingTalk, Lark, WeChat и других приложениях см. документацию [Настройка каналов](https://qwenpaw.agentscope.io/docs/channels).

![Console](https://img.alicdn.com/imgextra/i2/O1CN01EP1ra01iOAcBvF0TC_!!6000000004402-2-tps-3822-2070.png)

---

### Вариант 2: Установка через скрипт

Не требуется ручная настройка Python — одна команда устанавливает всё. Скрипт автоматически загрузит uv (менеджер пакетов Python), создаст виртуальное окружение и установит QwenPaw со всеми зависимостями (включая Node.js и frontend-ресурсы). Примечание: может не работать в ограниченных сетевых окружениях или при корпоративном контроле доступа.

**macOS / Linux:**

```bash
curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash
```

**Windows (CMD):**

```CMD
curl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat
```

**Windows (PowerShell):**

```powershell
irm https://qwenpaw.agentscope.io/install.ps1 | iex
```

> **Примечание**: Установщик автоматически проверит статус uv. Если он не установлен, будет предпринята попытка автоматической загрузки и настройки. Если автоматическая установка не удалась, следуйте инструкциям на экране или выполните `python -m pip install -U uv`, затем повторно запустите установщик.

> **⚠️ Специальное уведомление для пользователей Windows Enterprise LTSC**
>
> Если вы используете Windows LTSC или корпоративную среду с строгими политиками безопасности, PowerShell может работать в **режиме ограниченного языка**, что может вызвать следующие проблемы:
> 1. **При использовании CMD (.bat): Скрипт выполняется успешно, но не может записать в `Path`**
>
>    Скрипт завершает установку файлов. Из-за **режима ограниченного языка** он не может автоматически обновить переменные окружения. Настройте вручную следующим образом:
>    - **Найдите директорию установки**:
>      - Проверьте доступность `uv`: Введите `uv --version` в CMD. Если отображается номер версии, **настройте только путь QwenPaw**. Если появляется сообщение `'uv' is not recognized as an internal or external command, operable program or batch file,` настройте оба пути.
>      - Путь uv (выберите один в зависимости от места установки; используйте, если `uv` недоступен): Обычно `%USERPROFILE%\.local\bin`, `%USERPROFILE%\AppData\Local\uv` или папка `Scripts` в директории установки Python
>      - Путь QwenPaw: Обычно находится в `%USERPROFILE%\.qwenpaw\bin`.
>    - **Вручную добавьте в системную переменную окружения Path**:
>      - Нажмите `Win + R`, введите `sysdm.cpl` и нажмите Enter, чтобы открыть свойства системы.
>      - Нажмите «Дополнительно» → «Переменные среды».
>      - В «Системных переменных» найдите и выберите `Path`, затем нажмите «Изменить».
>      - Нажмите «Создать», последовательно введите оба пути к директориям, затем нажмите OK для сохранения.
> 2. **При использовании PowerShell (.ps1): Выполнение скрипта прерывается**
>
>   Из-за **режима ограниченного языка** скрипт может не суметь автоматически загрузить `uv`.
>   - **Установите uv вручную**: Обратитесь к [GitHub Release](https://github.com/astral-sh/uv/releases), загрузите `uv.exe` и поместите его в `%USERPROFILE%\.local\bin` или `%USERPROFILE%\AppData\Local\uv`; или убедитесь, что Python установлен, и выполните `python -m pip install -U uv`.
>   - **Настройте переменные окружения `uv`**: Добавьте директорию `uv` и `%USERPROFILE%\.qwenpaw\bin` в системную переменную `Path`.
>   - **Повторно запустите установку**: Откройте новый терминал и снова выполните скрипт установки для завершения установки `QwenPaw`.
>   - **Настройте переменную окружения `QwenPaw`**: Добавьте `%USERPROFILE%\.qwenpaw\bin` в системную переменную `Path`.

После установки откройте новый терминал и выполните:

```bash
qwenpaw init --defaults   # или: qwenpaw init (интерактивный)
qwenpaw app
```

<details>
<summary><b>Опции установки</b></summary>

**macOS / Linux:**

```bash
# Установить конкретную версию
curl -fsSL ... | bash -s -- --version 1.1.0

# Установить из исходников (для разработки/тестирования)
curl -fsSL ... | bash -s -- --from-source

# Обновление — просто повторно запустите установщик
curl -fsSL ... | bash

# Удаление
qwenpaw uninstall          # сохраняет конфигурацию и данные
qwenpaw uninstall --purge  # удаляет всё
```

**Windows (PowerShell):**

```powershell
# Установить конкретную версию
irm ... | iex; .\install.ps1 -Version 1.1.12

# Установить из исходников (для разработки/тестирования)
.\install.ps1 -FromSource

# Обновление — просто повторно запустите установщик
irm ... | iex

# Удаление
qwenpaw uninstall          # сохраняет конфигурацию и данные
qwenpaw uninstall --purge  # удаляет всё
```

</details>


---

### Вариант 3: Docker

Образы доступны на **Docker Hub** (`agentscope/qwenpaw`). Теги образов: `latest` (стабильная версия); `pre` (предварительный релиз PyPI).

```bash
docker pull agentscope/qwenpaw:latest
docker run -p 127.0.0.1:8088:8088 \
  -v qwenpaw-data:/app/working \
  -v qwenpaw-secrets:/app/working.secret \
  -v qwenpaw-backups:/app/working.backups \
  agentscope/qwenpaw:latest
```

Для пользователей в Китае также доступен Alibaba Cloud Container Registry (ACR): `agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/qwenpaw` (те же теги).

Затем откройте **http://127.0.0.1:8088/** для доступа к консоли. Конфигурация, память и навыки сохраняются в томе `qwenpaw-data`; настройки провайдеров моделей и API-ключи — в томе `qwenpaw-secrets`; архивы резервных копий — в томе `qwenpaw-backups`. Для передачи API-ключей (например, `DASHSCOPE_API_KEY`) добавьте `-e VAR=value` или `--env-file .env` в команду `docker run`.

> **Подключение к Ollama или другим сервисам на хост-машине**
>
> Внутри Docker-контейнера `localhost` указывает на сам контейнер, а не на хост-машину. Если Ollama (или другие модельные сервисы) запущены на хосте и вы хотите, чтобы QwenPaw в Docker мог к ним обращаться, используйте один из следующих подходов:
>
> **Вариант A** — Явная привязка к хосту (все платформы):
> ```bash
> docker run -p 127.0.0.1:8088:8088 \
>   --add-host=host.docker.internal:host-gateway \
>   -v qwenpaw-data:/app/working \
>   -v qwenpaw-secrets:/app/working.secret \
>   -v qwenpaw-backups:/app/working.backups \
>   agentscope/qwenpaw:latest
> ```
> Затем в QwenPaw **Настройки → Модели** измените Base URL на `http://host.docker.internal:<порт>` — например, `http://host.docker.internal:11434` для Ollama или `http://host.docker.internal:1234/v1` для LM Studio.
>
> **Вариант B** — Сеть хоста (только Linux):
> ```bash
> docker run --network=host \
>   -v qwenpaw-data:/app/working \
>   -v qwenpaw-secrets:/app/working.secret \
>   -v qwenpaw-backups:/app/working.backups \
>   agentscope/qwenpaw:latest
> ```
> Сопоставление портов (`-p`) не требуется; контейнер напрямую использует сеть хоста. Обратите внимание, что все порты контейнера будут доступны на хосте, что может вызвать конфликты, если порт уже занят.
>

Образ собирается с нуля. Если нужно собрать образ самостоятельно, см. раздел [Build Docker image](scripts/README.md#build-docker-image) в `scripts/README.md`, затем отправьте в свой реестр образов.

---

### Вариант 4: Развертывание на Alibaba Cloud ECS

Для запуска QwenPaw на Alibaba Cloud (ECS) используйте развертывание в один клик: откройте [ссылку развертывания QwenPaw на Alibaba Cloud ECS](https://computenest.console.aliyun.com/service/instance/create/cn-hangzhou?type=user&ServiceId=service-1ed84201799f40879884) и следуйте инструкциям. Пошаговые инструкции см. в [Сообщество разработчиков Alibaba Cloud: Развертывание вашего AI-ассистента за 3 минуты](https://developer.aliyun.com/article/1713682).

---

### Вариант 5: AgentScope Platform

[AgentScope Platform](https://platform.agentscope.io/) обеспечивает развертывание QwenPaw в облаке в один клик, обмен плагинами и маркет Skill. Бесплатно, работает 7/24 онлайн.

---

### Вариант 6: Использование ModelScope

[ModelScope Studio](https://modelscope.cn/studios/fork?target=AgentScope/QwenPaw) также поддерживает облачное развертывание QwenPaw. Примечание: установите свою студию как **непубличную**, иначе другие смогут управлять вашим QwenPaw.

---

### Вариант 7: Десктопное приложение (Beta)

> **Уведомление о Beta-версии**: Десктопное приложение в настоящее время находится на стадии Beta-тестирования со следующими известными ограничениями:
> - **Неполное тестирование совместимости**: Не полностью протестировано на всех версиях систем и конфигурациях оборудования
> - **Возможны проблемы с производительностью**: Время запуска, использование памяти и другие аспекты производительности могут требовать дополнительной оптимизации
> - **Функции продолжают совершенствоваться**: Некоторые функции могут быть нестабильными или отсутствовать

Если вы не привыкли использовать командную строку, можете загрузить и использовать десктопную версию QwenPaw без ручной настройки Python-окружения или выполнения команд.

#### Загрузка

Загрузите десктопное приложение (сборка Tauri) с [официальной страницы загрузки](https://qwenpaw.agentscope.io/downloads):
- **Windows**: `QwenPaw-Tauri-<version>-Windows-setup.exe`
- **macOS**: `QwenPaw-Tauri-<version>-macOS.zip` (рекомендуется для Apple Silicon)

#### Особенности

- ✅ **Нулевая настройка**: Загрузите и запустите двойным щелчком, не нужно устанавливать Python или настраивать переменные окружения
- ✅ **Кроссплатформенность**: Поддержка Windows 10+ и macOS 14+
- ✅ **Визуальный интерфейс**: Автоматически открывает окно приложения, не нужно вручную вводить адрес
- ⚠️ **Beta-стадия**: Функции продолжают совершенствоваться, приветствуется обратная связь

#### Первый запуск

**Важно**: Первый запуск может занять 10–60 секунд (в зависимости от конфигурации вашей системы). Приложению необходимо инициализировать Python-окружение и загрузить зависимости. Пожалуйста, дождитесь автоматического открытия окна.

#### macOS: Обход системных ограничений безопасности

Когда вы загружаете приложение QwenPaw для macOS, macOS может отобразить: *«Apple не может проверить, что "QwenPaw" не содержит вредоносного ПО»*. Это происходит потому, что приложение не нотаризовано. Вы все равно можете открыть его следующими способами:

- **Открытие через правый клик (рекомендуется)**
  Щелкните правой кнопкой (или Control + щелчок) по приложению QwenPaw → **«Открыть»** → в диалоговом окне снова нажмите **«Открыть»**. Это сообщит Gatekeeper, что вы доверяете приложению; после этого можно запускать его двойным щелчком как обычно.

- **Разрешить в системных настройках**
  Если всё ещё заблокировано, перейдите в **Системные настройки → Конфиденциальность и безопасность**, прокрутите до сообщения типа *«"QwenPaw" заблокирован, так как невозможно проверить разработчика»*, и нажмите **«Всё равно открыть»** или **«Разрешить»**.

- **Удалить атрибут карантина (не рекомендуется для большинства пользователей)**
  В терминале выполните:
  `xattr -cr "/Applications/QwenPaw Desktop.app"`
  (или используйте путь к `.app` после распаковки). Это очистит флаг карантина «загружено из интернета», поэтому предупреждение обычно не появляется, но это менее безопасно и контролируемо, чем использование **Правый клик → Открыть**.

Подробные инструкции, устранение неполадок и частые вопросы см. в [Руководстве по десктопному приложению](https://qwenpaw.agentscope.io/docs/desktop).

---

### Что дальше?

После установки настройте модель в **Консоль → Настройки → Модели**, затем изучите:

- [Добавьте Skills](https://qwenpaw.agentscope.io/docs/skills) для расширения возможностей (PDF, Office, браузер, новости и т.д.)
- [Настройте каналы](https://qwenpaw.agentscope.io/docs/channels) для DingTalk, Lark, Discord и других
- [Настройте Cron](https://qwenpaw.agentscope.io/docs/cron) для запланированных задач и автоматизации
- [Попробуйте Coding Mode](https://qwenpaw.agentscope.io/docs/coding-mode) для IDE-стиля работы с кодом
- Полное [руководство по быстрому старту](https://qwenpaw.agentscope.io/docs/quickstart) со всеми опциями и шагами проверки

---

## Терминальный интерфейс (TUI)

Предпочитаете оставаться в терминале? Запустите `qwenpaw` для полноэкранного чата в **TUI**, который управляет _тем же_ агентом, что и Консоль и IM-каналы — та же память, навыки, MCP-инструменты и сессии — без отрыва от клавиатуры.

```bash
qwenpaw                     # открыть чат с активным агентом
qwenpaw tui --resume <id>   # возобновить предыдущую сессию
qwenpaw .                   # начать в текущем репозитории (Coding Mode)
```

Поддерживаются потоковые ответы, slash-команды (`/help`, `/resume`, `/theme`, а также собственные команды агента `/model`, `/clear`, …), вставка файлов/длинного текста как вложений и inline-запросы разрешений на инструменты. Подробности см. в [руководстве по Terminal UI](https://qwenpaw.agentscope.io/docs/tui).

![QwenPaw TUI](https://img.alicdn.com/imgextra/i2/O1CN01IULzib1TRAzigIcqG_!!6000000002378-2-tps-2350-1312.png)

---

## API Key

Если вы используете **облачный API для LLM** (например, DashScope / Qwen, OpenAI, Anthropic, Google Gemini, DeepSeek, Kimi, OpenRouter и другие), перед началом диалога необходимо настроить API Key. До настройки действительного ключа QwenPaw не будет работать. Подробности см. в [официальной документации](https://qwenpaw.agentscope.io/docs/models).

**Способы настройки:**

1. **Консоль (рекомендуется)** — После запуска `qwenpaw app` откройте **http://127.0.0.1:8088/** → **Настройки** → **Модели**. Выберите провайдера, введите **API Key** и активируйте этого провайдера и модель.
2. **`qwenpaw init`** — При запуске `qwenpaw init` вас проведут через настройку LLM-провайдера и API Key. Следуйте подсказкам, выберите провайдера и введите ключ.
3. **Переменная окружения** — Для DashScope можно установить `DASHSCOPE_API_KEY` в терминале или в файле `.env` в рабочей директории.

Ключи для других инструментов (например, `TAVILY_API_KEY` для веб-поиска) можно настроить в консоли **Настройки → Переменные окружения**, подробности см. в [Конфигурация](https://qwenpaw.agentscope.io/docs/config).

> **Используете только локальные модели?** Если вы используете [Локальные модели](#локальные-модели) (QwenPaw Local / Ollama / LM Studio), вам **не нужен** никакой API Key.

## Локальные модели

QwenPaw может полностью запускать LLM на вашей машине — без API-ключей и облачных сервисов. Подробности см. в [официальной документации](https://qwenpaw.agentscope.io/docs/models).

QwenPaw также предоставляет серию **QwenPaw-Flash** — специально обученные модели 2B / 4B / 9B для агентных сценариев с квантизациями Q4 и Q8. Доступны на [ModelScope](https://www.modelscope.cn/organization/AgentScope?tab=model) и [Hugging Face](https://huggingface.co/agentscope-ai/models).

| Бэкенд              | Подходит для                             | Установка                                                                 |
| ------------------- | ---------------------------------------- | ------------------------------------------------------------------------- |
| **QwenPaw Local** (llama.cpp) | Кроссплатформенный (macOS / Linux / Windows) | Встроен; нажмите «Download» в веб-интерфейсе. Поддержка QwenPaw-Flash с рекомендациями с учётом железа. |
| **Ollama**          | Кроссплатформенный (требуется сервис Ollama) | Установите и запустите Ollama; установите длину контекста ≥ 32k. |
| **LM Studio**       | Кроссплатформенный (требуется LM Studio) | Установите и запустите LM Studio; включите Local Server. |

---

## Функции безопасности

QwenPaw включает четыре основных уровня безопасности:

- **Sandbox** — Изоляция выполнения на уровне ядра с помощью Seatbelt (macOS), Bubblewrap / Landlock (Linux) и AppContainer (Windows). Shell-команды выполняются в ограниченном представлении файловой системы.
- **Tool Guard** — YAML-движок правил с `ShellEvasionGuardian` проверяет каждый вызов инструмента перед выполнением, обнаруживая инъекции команд, обход путей, reverse shells и обфусцированные атаки. Настраиваемые уровни одобрения: STRICT / SMART / AUTO / OFF.
- **File Guard** — Независимо от Tool Guard; блокирует доступ агента к чувствительным файлам и директориям (по умолчанию защищает `~/.qwenpaw.secret/`, `~/.ssh` и т.д.).
- **Skill Scanner** — Сканирование перед активацией с режимами block / warn / off и поддержкой белого списка. Обнаруживает инъекции промптов, жёстко закодированные секреты, утечку данных и другое.
- **Access Policy** — Декларативные правила доступа: разрешение, запрет или запрос подтверждения для каждого вызова с гранулярностью до уровня инструмента и учётом источника запроса.

Подробности см. в разделе [Безопасность](https://qwenpaw.agentscope.io/docs/security).

---

## Документация

| Тема                                                                 | Описание                                        |
| -------------------------------------------------------------------- | ----------------------------------------------- |
| [Введение](https://qwenpaw.agentscope.io/docs/intro)                 | Что такое QwenPaw и как его использовать         |
| [Быстрый старт](https://qwenpaw.agentscope.io/docs/quickstart)       | Установка и запуск (локально или ModelScope Studio) |
| [Консоль](https://qwenpaw.agentscope.io/docs/console)                | Веб-интерфейс: чат и конфигурация агента        |
| [Terminal UI (TUI)](https://qwenpaw.agentscope.io/docs/tui)          | Полноэкранный терминальный чат, тот же агент, что и в Консоли |
| [Десктопное приложение](https://qwenpaw.agentscope.io/docs/desktop)  | Установка и использование десктопного приложения |
| [Модели](https://qwenpaw.agentscope.io/docs/models)                  | Настройка облачных, локальных и пользовательских провайдеров |
| [Каналы](https://qwenpaw.agentscope.io/docs/channels)                | DingTalk, Lark, QQ, Discord, iMessage и другие |
| [Coding Mode](https://qwenpaw.agentscope.io/docs/coding-mode)        | Трёхпанельная Web IDE для задач с кодом         |
| [Skills](https://qwenpaw.agentscope.io/docs/skills)                  | Расширение и настройка возможностей             |
| [Плагины](https://qwenpaw.agentscope.io/docs/plugins)                | Система плагинов и Plugin Market                 |
| [MCP](https://qwenpaw.agentscope.io/docs/mcp)                          | Управление MCP-клиентами                        |
| [Persona](https://qwenpaw.agentscope.io/docs/persona)                | Настройка личности агента (SOUL / PROFILE)       |
| [Память](https://qwenpaw.agentscope.io/docs/memory)                  | Долговременная семантическая память (ReMe)       |
| [Память-эволюция и проактивное взаимодействие](https://qwenpaw.agentscope.io/docs/memory-evolving-and-proactive) | Эволюция памяти агента и проактивное взаимодействие |
| [Контекст](https://qwenpaw.agentscope.io/docs/context)               | Управление контекстом на базе Scroll             |
| [Магические команды](https://qwenpaw.agentscope.io/docs/commands)    | Управление состоянием диалога без ожидания AI   |
| [Heartbeat](https://qwenpaw.agentscope.io/docs/heartbeat)            | Запланированная самопроверка и дайджест         |
| [Cron / Запланированные задачи](https://qwenpaw.agentscope.io/docs/cron) | Запланированные задачи и автоматизация       |
| [Мультиагенты](https://qwenpaw.agentscope.io/docs/multi-agent)       | Создание нескольких агентов и совместная работа |
| [Безопасность](https://qwenpaw.agentscope.io/docs/security)          | Sandbox, tool guard, file guard, skill scanner, access policy |
| [Резервное копирование и восстановление](https://qwenpaw.agentscope.io/docs/backup) | Резервное копирование и восстановление данных |
| [Конфигурация и рабочая директория](https://qwenpaw.agentscope.io/docs/config) | Рабочая директория и конфигурационный файл |
| [REST API](https://qwenpaw.agentscope.io/docs/api-tutorial)          | HTTP API для интеграции и автоматизации         |
| [Интеграция ACP](https://qwenpaw.agentscope.io/docs/acp-integration) | Интеграция Agent Communication Protocol         |
| [CLI](https://qwenpaw.agentscope.io/docs/cli)                        | Init, cron-задачи, skills, очистка              |
| [Практика агентных команд](https://qwenpaw.agentscope.io/docs/practice-agent-team) | Руководство по развертыванию мультиагентных команд |
| [FAQ](https://qwenpaw.agentscope.io/docs/faq)                        | Частые вопросы и устранение неполадок           |

Полная документация: [qwenpaw.agentscope.io/docs](https://qwenpaw.agentscope.io/docs)

---

## FAQ

Для часто задаваемых вопросов, советов по устранению неполадок и известных проблем посетите **[страницу FAQ](https://qwenpaw.agentscope.io/docs/faq)**.

---

## Дорожная карта

| Направление                                     | Задача                                                                                                      | Статус          |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | --------------- |
| **Горизонтальное расширение**                   | Больше каналов, моделей, навыков, MCP — **приветствуются вклады сообщества**                               | Ищем участников |
| **Расширение и улучшение существующих функций** | Оптимизация отображения, подсказки при загрузке, совместимость путей Windows и т.д. — **приветствуются вклады сообщества** | Ищем участников |
| **Модели**                                      | Переключение между несколькими моделями                                                                     | В работе        |
| **Browser-use**                                 | Поддержка расширения Chrome                                                                                 | В работе        |
| **Долговременная память**                       | Персональная база знаний                                                                                    | В работе        |
| **Приложение QwenPaw**                          | QwenPaw Creator                                                                                             | В работе        |
|                                                 | QwenPaw Insight                                                                                             | В работе        |
| **Мультиагенты**                                | Совместимость с существующими агентами (напр. Claude Code)                                                  | Запланировано   |
|                                                 | Групповой чат                                                                                               | Запланировано   |
|                                                 | Визуализация Subagent                                                                                       | Запланировано   |

_Статусы:_ **В работе** — активно ведётся разработка; **Запланировано** — в очереди или на стадии проектирования, вклады также приветствуются; **Ищем участников** — мы настоятельно призываем к участию сообщества.

---

## Участие в проекте

QwenPaw развивается через открытую совместную работу, и мы приветствуем любые формы участия! Ознакомьтесь с [Дорожной картой](#дорожная-карта) выше (особенно с пунктами, отмеченными как **Ищем участников**), чтобы найти интересующие вас области, и прочитайте [CONTRIBUTING](https://github.com/agentscope-ai/QwenPaw/blob/main/CONTRIBUTING.md), чтобы начать. Мы особенно приветствуем:

- **Горизонтальное расширение** — новые каналы, провайдеры моделей, Skills, MCP.
- **Расширение и улучшение существующих функций** — оптимизация отображения и взаимодействия, подсказки при загрузке, совместимость путей Windows и т.д.

Присоединяйтесь к обсуждениям на [GitHub Discussions](https://github.com/agentscope-ai/QwenPaw/discussions), чтобы обсуждать идеи или браться за задачи.

---

## Установка из исходников

```bash
git clone https://github.com/agentscope-ai/QwenPaw.git
cd QwenPaw

# Сначала соберите frontend консоли (необходимо для веб-интерфейса)
cd console && npm ci && npm run build
cd ..

# Скопируйте результат сборки консоли в директорию пакета
mkdir -p src/qwenpaw/console
cp -R console/dist/. src/qwenpaw/console/

# Установите Python-пакет
pip install -e .
```

- **Разработка** (тесты, форматирование): `pip install -e ".[dev,full]"`
- **Затем**: Выполните `qwenpaw init --defaults`, затем `qwenpaw app`.

> **Примечание при обновлении:** При обновлении до новой мажорной версии после `git pull` пересоберите frontend, переустановите пакет (`pip install -e .`), перезапустите `qwenpaw app` и очистите кэш браузера (`Ctrl+Shift+R` или `Cmd+Shift+R` на macOS).

---

## Почему QwenPaw?

QwenPaw расшифровывается как Qwen Personal Agent Workstation и воплощает мудрость Qwen и теплоту Paw. Мы хотим, чтобы это был не холодный инструмент, а умная и тёплая «маленькая лапка», всегда готовая прийти на помощь — самый интуитивный партнёр в вашей цифровой жизни.

---

## Кто разрабатывает

[Команда AgentScope](https://github.com/agentscope-ai) · [AgentScope](https://github.com/agentscope-ai/agentscope) · [AgentScope Runtime](https://github.com/agentscope-ai/agentscope-runtime) · [ReMe](https://github.com/agentscope-ai/ReMe)

---

## Связаться с нами

| [Discord](https://discord.gg/eYMpfnkG8h)                     | [X (Twitter)](https://x.com/agentscope_ai)                   | [DingTalk](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11) | [RedNote](https://www.xiaohongshu.com/user/profile/691c18db0000000037032be9) |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| [<img src="https://gw.alicdn.com/imgextra/i1/O1CN01hhD1mu1Dd3BWVUvxN_!!6000000000238-2-tps-400-400.png" width="80" height="80" alt="Discord">](https://discord.gg/eYMpfnkG8h) | [<img src="https://img.shields.io/badge/X-black.svg?logo=x&logoColor=white" width="80" height="80" alt="X">](https://x.com/agentscope_ai) | [<img src="https://img.alicdn.com/imgextra/i2/O1CN01vCWI8a1skHtLGXEMQ_!!6000000005804-2-tps-458-460.png" width="80" height="80" alt="DingTalk">](https://qr.dingtalk.com/action/joingroup?code=v1,k1,OmDlBXpjW+I2vWjKDsjvI9dhcXjGZi3bQiojOq3dlDw=&_dt_no_comment=1&origin=11) | [<img src="https://img.alicdn.com/imgextra/i3/O1CN016BoEPS1l33CE9mHb9_!!6000000004762-0-tps-160-160.jpg" width="80" height="80" alt="RedNote">](https://www.xiaohongshu.com/user/profile/691c18db0000000037032be9) |

---

## Будьте в курсе

<a href="https://github.com/agentscope-ai/QwenPaw">
  <img src="https://img.alicdn.com/imgextra/i1/O1CN01V8HYv61By0HYcIDaq_!!6000000000013-1-tps-1698-954.gif" width="600" alt="Star QwenPaw" />
</a>

Поставьте звезду QwenPaw на GitHub, чтобы мгновенно получать уведомления о новых релизах.

---

## Телеметрия

QwenPaw собирает **анонимные** данные об использовании при выполнении `qwenpaw init`, чтобы помочь нам понять пользовательскую базу и расставить приоритеты улучшений. Данные отправляются **один раз на версию** — при обновлении QwenPaw телеметрия собирается повторно для отслеживания распространения версий.

**Собираемая информация:**

- Версия QwenPaw (например, 1.1.12)
- Способ установки (pip, Docker или десктопное приложение)
- Операционная система и версия (например, macOS 14.0, Ubuntu 22.04)
- Версия Python (например, 3.13)
- Архитектура CPU (например, x86_64, arm64)
- Доступность GPU (да/нет)

**Не собирается:** Никакие персональные данные, файлы, ключи, IP-адреса или идентифицируемая информация.

При интерактивном запуске `qwenpaw init` вас спросят о согласии. При использовании `--defaults` согласие даётся автоматически. Запрос появляется один раз на версию и не влияет на функциональность QwenPaw.

---

## Лицензия

QwenPaw выпускается под лицензией [Apache License 2.0](LICENSE).

---

## Участники

Благодарим всех, кто внёс вклад в развитие QwenPaw:

<a href="https://github.com/agentscope-ai/QwenPaw/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=agentscope-ai/QwenPaw" alt="Участники" />
</a>
