> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WeChat

> CowAgent を個人の WeChat に接続する

> 個人の WeChat に接続します。QR コードをスキャンするだけでログインでき、パブリック IP は不要です。テキスト、画像、音声、ファイル、動画メッセージの送受信に対応しています。

## 1. 設定

### 方法 A: Web コンソール

プログラムを起動し、Web コンソール（ローカルアクセス: [http://127.0.0.1:9899）を開きます。\*\*チャネル\*\*タブに移動し、\*\*チャネルを接続\*\*をクリックして](http://127.0.0.1:9899）を開きます。**チャネル**タブに移動し、**チャネルを接続**をクリックして) **WeChat** を選択し、プロンプトに従って QR コードをスキャンしてください。

### 方法 B: 設定ファイル

`config.json` で `channel_type` を `weixin` に設定します：

```json theme={null}
{
  "channel_type": "weixin"
}
```

プログラム起動後、ターミナルに QR コードが表示されます。WeChat でスキャンし、スマートフォンで確認してログインを完了してください。

<Note>
  後方互換性のため、`channel_type` を `wx` に設定しても WeChat チャネルが有効になります。
</Note>

## 2. パラメータ

| パラメータ          | 説明                    | デフォルト |
| -------------- | --------------------- | ----- |
| `channel_type` | `weixin` または `wx` を指定 | —     |

ログイン認証情報は `~/.weixin_cow_credentials.json` に自動保存されます。再ログインするには、このファイルを削除してプログラムを再起動してください。

## 3. ログイン

### QR コードログイン

初回起動時に、ターミナルに QR コードが表示されます（有効期限は約 2 分）。WeChat でスキャンし、スマートフォンで確認してください。

* QR コードが期限切れになると自動的に更新・再表示されます
* `qrcode` 依存関係は `requirements.txt` にデフォルトで含まれており、ターミナルに直接 QR コードを表示できます

### 認証情報の永続化

ログイン成功後、認証情報は `~/.weixin_cow_credentials.json` に保存されます。次回起動時は保存された認証情報が再利用され、再スキャンは不要です。

再ログインするには、認証情報ファイルを削除してプログラムを再起動してください。

### セッションの期限切れ

WeChat セッションが期限切れになった場合（errcode -14）、プログラムは自動的に古い認証情報をクリアし、新しい QR ログインを開始します。手動での操作は不要です。

## 4. 対応機能

| 機能         | 状態    |
| ---------- | ----- |
| ダイレクトメッセージ | ✅     |
| テキストメッセージ  | ✅ 送受信 |
| 画像メッセージ    | ✅ 送受信 |
| ファイルメッセージ  | ✅ 送受信 |
| 動画メッセージ    | ✅ 送受信 |
| 音声メッセージ    | ✅ 受信  |

## 5. 注意事項

1. `ilinkai.weixin.qq.com` へのネットワークアクセスが必要です。
2. メディアファイル（画像、ファイル、動画）は CDN 経由で AES-128-ECB 暗号化を使用して転送され、プログラムが自動的に処理します。
3. 頻繁な切断による再スキャンを避けるため、安定したネットワーク環境での実行を推奨します。