個人の WeChat に接続します。QR コードをスキャンするだけでログインでき、パブリック IP は不要です。テキスト、画像、音声、ファイル、動画メッセージの送受信に対応しています。
1. 設定
方法 A: Web コンソール
プログラムを起動し、Web コンソール(ローカルアクセス: http://127.0.0.1:9899)を開きます。**チャネル**タブに移動し、**チャネルを接続**をクリックして WeChat を選択し、プロンプトに従って QR コードをスキャンしてください。
方法 B: 設定ファイル
config.json で channel_type を weixin に設定します:
{
"channel_type": "weixin"
}
プログラム起動後、ターミナルに QR コードが表示されます。WeChat でスキャンし、スマートフォンで確認してログインを完了してください。
後方互換性のため、channel_type を wx に設定しても WeChat チャネルが有効になります。
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. 注意事項
ilinkai.weixin.qq.com へのネットワークアクセスが必要です。
- メディアファイル(画像、ファイル、動画)は CDN 経由で AES-128-ECB 暗号化を使用して転送され、プログラムが自動的に処理します。
- 頻繁な切断による再スキャンを避けるため、安定したネットワーク環境での実行を推奨します。