---
title: WeChat
description: CowAgent を個人の WeChat に接続する
---

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

## 1. 設定

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

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

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

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

```json
{
  "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. 頻繁な切断による再スキャンを避けるため、安定したネットワーク環境での実行を推奨します。
