<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_ru.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 で拡張、あらゆるチャネルで接続。

| | |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **忘れない**                               | 3 層メモリ — ライブな作業コンテキスト、完全な逐語履歴、蒸留された知識。古いターンは退避されるが必要に応じていつでも呼び出し可能。要約で失われることはなく、情報は失われない。                                                                           |
| **ローカルもクラウドも、自由に動く**        | QwenPaw-Flash モデル（2B / 4B / 9B）— エージェントタスク向けに訓練。内蔵 QwenPaw Local ランタイム — API キー不要、クラウド依存なし。Ollama、LM Studio、14+ クラウドプロバイダーにも対応。                  |
| **セキュリティ内蔵**                         | カーネルレベルの Sandbox、Tool Guard、File Guard、Skill Scanner。危険なコマンドは実行前にブロック。                                                                                    |
| **マルチエージェント＆並列**                | 独自のメモリとスキルを持つ独立エージェントを生成。実行時のサブエージェント。Agent Communication Protocol（ACP）によるクロスシステム編成。                                                                         |
| **Coding Mode**                               | 3 パネル Web IDE — ファイルツリー、Diff プレビュー、チャット。定義へジャンプ、参照検索、構造コード検索を内蔵。                                                                                                 |
| **拡張可能**                                | スケジューリング、ドキュメント、ブラウザ、ニュースなどの Skills。マーケット付きプラグインアーキテクチャ。MCP で外部ツールを統合。目的別ワークフローに自由に組み合わせ可能。                                                                    |
| **どこでも届く**                        | DingTalk、Lark、WeChat、Discord、Telegram、iMessage、QQ — 1 インスタンス、全チャネル。Console、TUI、デスクトップアプリで直接アクセス。                                                                         |
| **あなたのもの、私たちのものではない**          | ローカル展開 — データはあなたのマシンに留まる。サードパーティホスティングなし、データアップロードなし。                                                                                                         |

> <details>
> <summary><b>QwenPaw でできること</b></summary>
>
> <br>
>
> - **自動化 & スケジューリング**: 定期タスクを設定 — ニュースダイジェスト、レポート生成、マルチチャネル配信 — すべてスケジュール通りに自動実行。
> - **コード & 開発**: プロジェクト内でコードの読み取り、編集、レビュー、テスト；Coding Mode でコードを素早く見つけて理解。
> - **ドキュメント処理**: PDF、Word、Excel、PowerPoint の読み取り、書き込み、変換。
> - **情報収集**: Web 検索、購読情報のフォロー、動画要約、個人ナレッジベースからの検索。
> - **マルチチャネル運用**: DingTalk、Lark、Discord、Telegram などへアラート、要約、AI 生成コンテンツをプッシュ — 同時またはチャネル別。
> - **カスタムワークフロー**: 組み込み機能、プラグイン、定期タスクを組み合わせて、自分に合ったワークフローを構築。
>
> </details>

---

## ニュース

- [2026-07-10] **v2.0.0 — QwenPaw 2.0 正式リリース** 🎉 | AgentScope 2.0 ベースの全面リライト：Agent OS アーキテクチャ、Loop Engineering、Scroll Context、ReMe v0.4.0 Long-term Memory、組み込み TUI を提供。

  | ハイライト | 内容 |
  |-----------|------|
  | **Agent OS — Workspace** | エージェントごとの 3 本柱：**Resources**（透明なディスク保存）、**Governance**（allow/deny/ask/sandbox）、**Sandbox**（macOS / Linux / Windows）。 |
  | **Agent OS — Drivers** | プロトコル中立な MCP / A2A / ACP コネクタ層、暗号化資格情報と呼び出しごとのポリシーゲート付き。 |
  | **Loop Engineering** | 高度なエージェントループテンプレート（Coding Mode、Mission Mode、今後さらに追加予定）と組み合わせ可能な承認ゲート。 |
  | **Scroll Context** | 全ターンを永続化；退去ターンはインデックス付きでオンデマンド再生 — 要約なし、情報欠落なし。 |
  | **ReMe v0.4.0 Long-term Memory** | ターンベースの自動追跡、利用感知型検索、バックエンド固有の埋め込み。 |
  | **Terminal UI (TUI)** | フルスクリーンターミナルチャット — Console やチャネルと同一のエージェント・記憶・セッション。 |

  Agent OS をベースに、すぐに使える QwenPaw アプリケーション — **QwenPaw Creator**、**QwenPaw Insight** など — を順次リリース予定です。 [v2.0.0 リリースノート →](https://qwenpaw.agentscope.io/release-notes#v2.0.0)

- [2026-06-17] **v1.1.12 — モデルページ大刷新 & シンプルモード** | Provider 集約による新モデルページデザイン、フラットナビのシンプルモード追加。[v1.1.12 リリースノート →](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 リリースノート →](https://qwenpaw.agentscope.io/release-notes#v1.1.11)

[すべてのリリースノート →](https://qwenpaw.agentscope.io/release-notes)

---

## 目次

- [ニュース](#ニュース)
- [クイックスタート](#クイックスタート)
- [API キー](#api-キー)
- [ローカルモデル](#ローカルモデル)
- [セキュリティ機能](#セキュリティ機能)
- [ドキュメント](#ドキュメント)
- [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: Script Install

Python 環境の手動設定は不要。1 つのコマンドで自動的にすべてをインストール。スクリプトは uv（Python パッケージマネージャー）のダウンロード、仮想環境の作成、QwenPaw と全依存関係（Node.js とフロントエンドアセットを含む）のインストールを自動的に行います。注：一部のネットワーク環境や企業の権限管理下では使用できない場合があります。

**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` の利用可否を確認：CMD で `uv --version` と入力し、バージョン番号が表示された場合は **QwenPaw パスのみ設定**。`『uv』 は内部コマンドでも外部コマンドでもなく、実行可能プログラムまたはバッチファイルでもありません。` と表示された場合は両方を設定する必要があります。
>      - uv パス（いずれか一つ、インストール場所に応じて選択。`uv` が利用不可の場合に記入）：通常 `%USERPROFILE%\.local\bin`、`%USERPROFILE%\AppData\Local\uv`、または Python インストールディレクトリの `Scripts` フォルダ
>      - QwenPaw パス：通常 `%USERPROFILE%\.qwenpaw\bin` にあります。
>    - **システム環境変数 Path への手動追加**：
>      - `Win + R` を押し、`sysdm.cpl` と入力して Enter キーを押し、「システムのプロパティ」を開く。
>      - 「詳細設定」→「環境変数」をクリック。
>      - 「システム変数」で `Path` を探して選択し、「編集」をクリック。
>      - 「新規」をクリックし、上記の 2 つのディレクトリパスを順に入力して「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
```

中国のユーザーは阿里雲コンテナレジストリ（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`）を渡すには、`docker run` に `-e VAR=value` または `--env-file .env` を追加してください。

> **ホストマシン上の Ollama や他のモデルサービスに接続する**
>
> Docker コンテナ内の `localhost` はコンテナ自身を指し、ホストマシンではありません。Ollama（または他のモデルサービス）がホスト上で動作している場合、以下のいずれかの方法で QwenPaw コンテナからアクセスできます：
>
> **方法 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:<ポート>` に変更してください — 例えば、Ollama の場合は `http://host.docker.internal:11434`、LM Studio の場合は `http://host.docker.internal:1234/v1` とします。
>
> **方法 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`）は不要で、コンテナはホストネットワークを直接共有します。ただし、コンテナの全ポートがホスト上に公開されるため、使用中のポートと競合する可能性があります。
>

イメージはゼロからビルドされています。自分でイメージをビルドする場合は、`scripts/README.md` の [Build Docker image](scripts/README.md#build-docker-image) セクションを参照し、レジストリにプッシュしてください。

---

### オプション 4: Alibaba Cloud ECS へのデプロイ

QwenPaw を Alibaba Cloud（ECS）で実行するには、ワンクリックデプロイを使用します: [QwenPaw on Alibaba Cloud (ECS) デプロイリンク](https://computenest.console.aliyun.com/service/instance/create/cn-hangzhou?type=user&ServiceId=service-1ed84201799f40879884) を開き、プロンプトに従ってください。ステップバイステップの手順については、[Alibaba Cloud Developer: 3 分で AI アシスタントをデプロイ](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 を操作できないよう、Studio を **非公開** に設定してください。

---

### オプション 7: Desktop Application (Beta)

> **Beta 版の注意事項**: デスクトップアプリケーションは現在 Beta 版テスト段階にあり、以下の既知の制限があります：
> - **互換性テストが不完全**: すべてのシステムバージョンとハードウェア構成で十分にテストされていません
> - **パフォーマンスの問題の可能性**: 起動時間、メモリ使用量などのパフォーマンス面でさらなる最適化が必要な場合があります
> - **開発中の機能**: 一部の機能が不安定または欠落している可能性があります

コマンドラインツールに慣れていない場合、QwenPaw のデスクトップアプリケーションをダウンロードして使用できます。Python 環境の手動設定やコマンドの実行は不要です。

#### ダウンロード

[公式ダウンロードページ](https://qwenpaw.agentscope.io/downloads) からデスクトップアプリ（Tauri 版）をダウンロード:
- **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: システムセキュリティ制限の回避

Releases から QwenPaw macOS アプリをダウンロードすると、macOS は次のように表示する場合があります: *「Apple は 'QwenPaw' に悪意のあるソフトウェアが含まれていないことを確認できません」*。これはアプリが公証されていないためです。以下の方法で開くことができます:

- **右クリックして開く（推奨）**
  QwenPaw アプリを右クリック（または Control+クリック）→ **「開く」** → ダイアログで再度 **「開く」** をクリック。これにより Gatekeeper にアプリを信頼していることを伝えます。その後は通常通りダブルクリックで起動できます。

- **システム設定で許可**
  それでもブロックされる場合、**システム設定 → プライバシーとセキュリティ** に移動し、*「'QwenPaw' は未確認の開発元からのものであるためブロックされました」* のようなメッセージまでスクロールし、**「このまま開く」** または **「許可」** をクリックします。

- **検疫属性の削除（ほとんどのユーザーには非推奨）**
  ターミナルで実行:
  `xattr -cr "/Applications/QwenPaw Desktop.app"`
  （または解凍後の `.app` へのパスを使用）。これにより「インターネットからダウンロードされた」検疫フラグがクリアされ、通常は警告が表示されなくなりますが、**右クリック → 開く** を使用するよりも安全性と制御性が低くなります。

詳細な使用方法、トラブルシューティング、よくある問題については、[デスクトップアプリケーションガイド](https://qwenpaw.agentscope.io/docs/desktop) を参照してください。

---

### 次は何をする？

インストール後、**コンソール → 設定 → モデル** でモデルを設定し、以下を探索してください：

- [スキルを追加](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) を参照

---

## ターミナル UI（TUI）

ターミナルで完結したい場合、`qwenpaw` を実行するとフルスクリーンのチャット **TUI** が開きます。コンソールや IM チャネルと **同じ** エージェントを駆動 — 同じメモリ、スキル、MCP ツール、セッション — キーボードから離れずに操作できます。

```bash
qwenpaw                     # アクティブなエージェントでチャットを開く
qwenpaw tui --resume <id>   # 以前のセッションを再開
qwenpaw .                   # 現在のリポジトリで開始（Coding Mode）
```

ストリーミング応答、スラッシュコマンド（`/help`、`/resume`、`/theme`、エージェント独自の `/model`、`/clear` など）、ファイル/長文の貼り付け添付、インラインツール権限プロンプトに対応。詳細は [ターミナル UI ガイド](https://qwenpaw.agentscope.io/docs/tui) を参照してください。

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

---

## API キー

**クラウド LLM API**（例: DashScope / Qwen、OpenAI、Anthropic、Google Gemini、DeepSeek、Kimi、OpenRouter など）を使用する場合、チャットの前に API キーを設定する必要があります。有効なキーが設定されるまで QwenPaw は動作しません。詳細は [公式ドキュメント](https://qwenpaw.agentscope.io/docs/models) をご覧ください。

**設定方法:**

1. **コンソール（推奨）** — `qwenpaw app` 実行後、**http://127.0.0.1:8088/** を開き → **設定** → **モデル**。プロバイダーを選択し、**API キー** を入力して、そのプロバイダーとモデルを有効にしてください。
2. **`qwenpaw init`** — `qwenpaw init` を実行すると、LLM プロバイダーと API キーの設定が案内されます。プロンプトに従ってプロバイダーを選択し、キーを入力してください。
3. **環境変数** — DashScope の場合、シェルまたはワーキングディレクトリの `.env` ファイルで `DASHSCOPE_API_KEY` を設定できます。

その他のキー（例: Web 検索用 `TAVILY_API_KEY`）は、コンソールの **設定 → 環境変数** で設定できます。詳細は [Config](https://qwenpaw.agentscope.io/docs/config) を確認してください。

> **ローカルモデルのみ使用する場合:** [ローカルモデル](#ローカルモデル)（QwenPaw Local / Ollama / LM Studio）を使用する場合、API キーは **不要** です。

## ローカルモデル

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） | 内蔵；Web UI で「Download」をクリック。QwenPaw-Flash に対応、ハードウェアに応じた推奨あり。 |
| **Ollama**           | クロスプラットフォーム（Ollama サービスが必要） | Ollama をインストールして起動；コンテキスト長 ≥ 32k を設定。 |
| **LM Studio**        | クロスプラットフォーム（LM Studio が必要）      | LM Studio をインストールして起動；Local Server を有効化。 |

---

## セキュリティ機能

QwenPaw には 4 つのコアセキュリティレイヤーが含まれています：

- **Sandbox** — macOS では Seatbelt、Linux では Bubblewrap / Landlock、Windows では AppContainer によるカーネルレベルの実行分離。シェルコマンドは制限されたファイルシステムビュー内で実行されます。
- **Tool Guard** — YAML ルールエンジンと `ShellEvasionGuardian` が実行前にすべてのツール呼び出しを検査し、コマンドインジェクション、パストラバーサル、リバースシェル、難読化攻撃を検出。承認レベル設定可能：STRICT / SMART / AUTO / OFF。
- **File Guard** — Tool Guard とは独立；エージェントの機密ファイル・ディレクトリへのアクセスをブロック（デフォルトで `~/.qwenpaw.secret/`、`~/.ssh` などを保護）。
- **Skill Scanner** — block / warn / off モードとホワイトリスト対応の事前アクティベーションスキャン。プロンプトインジェクション、ハードコードされた秘密情報、データ流出などを検出。
詳細は [セキュリティ](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)                   | Web UI: チャットとエージェント設定            |
| [ターミナル 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)           | コード中心タスク向け 3 パネル Web IDE       |
| [スキル](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 の応答を待たずに会話状態を制御 |
| [ハートビート](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 ジョブ、スキル、クリーン                   |
| [エージェントチーム実践](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 など既存 Agent との互換                                        | 計画中              |
|          | グループチャット                                                                                   | 計画中              |
|                          | サブエージェントの可視化                                                                                 | 計画中              |

_状態:_ **進行中** — 積極的に開発中；**計画中** — キューまたは設計段階、貢献も歓迎；**貢献者募集中** — コミュニティの参加を強く推奨。

---

## コントリビュート

QwenPaw はオープンな協働により進化を続けており、あらゆる形の貢献を歓迎しています！上記の [ロードマップ](#ロードマップ)（特に **貢献者募集中** の項目）から興味のある領域を選び、[CONTRIBUTING](https://github.com/agentscope-ai/QwenPaw/blob/main/CONTRIBUTING.md) を読んで始めてください。特に歓迎するのは：

- **横展開** — 新規チャネル、モデルプロバイダー、スキル、MCP。
- **既存機能の拡張 & 改善** — 表示と操作の最適化、ダウンロードヒント、Windows パス互換性など。

[GitHub Discussions](https://github.com/agentscope-ai/QwenPaw/discussions) でアイデアを議論したりタスクを引き受けたりしてください。

---

## ソースからインストール

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

# まずコンソールフロントエンドをビルド（Web UI に必須）
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` 後に新しいメジャーバージョンにアップデートする場合は、フロントエンドの再ビルド、パッケージの再インストール（`pip install -e .`）、`qwenpaw app` の再起動、およびブラウザキャッシュの削除（`Ctrl+Shift+R` または macOS では `Cmd+Shift+R`）も行ってください。

---

## なぜ QwenPaw？

QwenPaw は Qwen Personal Agent Workstation（Qwen 個人エージェントワークステーション）の略であると同時に、Qwen の知性と Paw の温もりを体現しています。単なる冷たいツールではなく、いつでも手を差し伸べてくれる、賢くて温かい「小さな爪」でありたい — あなたのデジタルライフで最も息の合ったパートナーです。

---

## 開発元

[AgentScope team](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>

GitHub で QwenPaw にスターを付けて、新しいリリースの通知を即座に受け取りましょう。

---

## テレメトリ

QwenPaw は `qwenpaw init` 実行時に **匿名** の利用データを収集し、ユーザー環境の把握と製品改善に役立てています。データは **バージョンごとに 1 回** 送信されます — QwenPaw をアップグレードすると、バージョン分布を把握するために再収集されます。

**収集する情報：**

- QwenPaw バージョン（例: 1.1.12）
- インストール方法（pip、Docker、またはデスクトップアプリ）
- OS とバージョン（例: macOS 14.0、Ubuntu 22.04）
- Python バージョン（例: 3.13）
- CPU アーキテクチャ（例: x86_64、arm64）
- GPU の利用可否（はい/いいえ）

**収集しないもの：** 個人データ、ファイル、認証情報、IP アドレス、個人を特定できる情報は一切収集しません。

`qwenpaw init` を対話モードで実行すると、同意するかどうか尋ねられます。`--defaults` モードでは自動的に同意されます。プロンプトはバージョンごとに 1 回のみ表示され、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>
