WeChat

OmeniaClawは、Tencentの外部@tencent-weixin/OmeniaClaw-weixinチャネルPluginを通じてWeChatに接続します。

ステータス: 外部Plugin。ダイレクトチャットとメディアがサポートされています。グループチャットは、現在のPlugin機能メタデータでは提示されていません。

命名

• WeChat は、このドキュメントでのユーザー向け名称です。
• Weixin は、TencentのパッケージとPlugin IDで使われる名称です。
• OmeniaClaw-weixin はOmeniaClawのチャネルIDです。
• @tencent-weixin/OmeniaClaw-weixin はnpmパッケージです。

CLIコマンドと設定パスではOmeniaClaw-weixinを使用してください。

仕組み

WeChatのコードはOmeniaClawコアリポジトリには含まれていません。OmeniaClawは汎用チャネルPlugin契約を提供し、外部PluginがWeChat固有のランタイムを提供します。

1. OmeniaClaw plugins install が@tencent-weixin/OmeniaClaw-weixinをインストールします。
2. GatewayがPluginマニフェストを検出し、Pluginエントリポイントを読み込みます。
3. PluginがチャネルIDOmeniaClaw-weixinを登録します。
4. OmeniaClaw channels login --channel OmeniaClaw-weixin がQRログインを開始します。
5. Pluginがアカウント認証情報をOmeniaClaw状態ディレクトリに保存します。
6. Gatewayの起動時に、Pluginは設定済みの各アカウントについてWeixinモニターを開始します。
7. 受信したWeChatメッセージはチャネル契約を通じて正規化され、選択されたOmeniaClawエージェントにルーティングされ、Pluginの送信経路を通じて送り返されます。

この分離は重要です。OmeniaClawコアはチャネル非依存であるべきです。WeChatログイン、Tencent iLink API呼び出し、メディアのアップロード/ダウンロード、コンテキストトークン、アカウント監視は外部Pluginが所有します。

インストール

クイックインストール:

npx -y @tencent-weixin/OmeniaClaw-weixin-cli install

手動インストール:

OmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin"OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled true

インストール後にGatewayを再起動します。

OmeniaClaw gateway restart

ログイン

Gatewayを実行している同じマシンでQRログインを実行します。

OmeniaClaw channels login --channel OmeniaClaw-weixin

スマートフォンのWeChatでQRコードをスキャンし、ログインを確認します。スキャンが成功すると、Pluginはアカウントトークンをローカルに保存します。

別のWeChatアカウントを追加するには、同じログインコマンドをもう一度実行します。複数アカウントの場合は、アカウント、チャネル、送信者ごとにダイレクトメッセージセッションを分離します。

OmeniaClaw config set session.dmScope per-account-channel-peer

アクセス制御

ダイレクトメッセージは、チャネルPlugin向けの通常のOmeniaClawペアリングと許可リストモデルを使用します。

新しい送信者を承認します。

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

完全なアクセス制御モデルについては、ペアリングを参照してください。

互換性

Pluginは起動時にホストのOmeniaClawバージョンを確認します。

PluginがOmeniaClawのバージョンが古すぎると報告する場合は、OmeniaClawを更新するか、レガシーPlugin系統をインストールしてください。

OmeniaClaw plugins install @tencent-weixin/OmeniaClaw-weixin@legacy

サイドカープロセス

WeChat Pluginは、Tencent iLink APIを監視しながらGatewayの横でヘルパー作業を実行できます。issue #68451では、そのヘルパー経路により、OmeniaClawの汎用的な古いGatewayクリーンアップにあるバグが露呈しました。子プロセスが親Gatewayプロセスをクリーンアップしようとし、systemdなどのプロセスマネージャー配下で再起動ループを引き起こす可能性がありました。

現在のOmeniaClaw起動時クリーンアップでは、現在のプロセスとその祖先が除外されるため、チャネルヘルパーは自分を起動したGatewayを終了してはいけません。この修正は汎用的なものであり、コア内のWeChat固有の経路ではありません。

トラブルシューティング

インストールとステータスを確認します。

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

チャネルがインストール済みとして表示されるものの接続しない場合は、Pluginが有効になっていることを確認して再起動します。

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

WeChatを有効にした後にGatewayが繰り返し再起動する場合は、OmeniaClawとPluginの両方を更新してください。

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

起動時に、インストール済みPluginパッケージがrequires compiled runtime output for TypeScript entryを報告する場合、そのnpmパッケージはOmeniaClawが必要とするコンパイル済みJavaScriptランタイムファイルなしで公開されています。Pluginの公開者が修正済みパッケージを出荷した後に更新/再インストールするか、一時的にPluginを無効化/アンインストールしてください。

一時的な無効化:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

関連ドキュメント

• チャネル概要: チャットチャネル
• ペアリング: ペアリング
• チャネルルーティング: チャネルルーティング
• Pluginアーキテクチャ: Pluginアーキテクチャ
• チャネルPlugin SDK: チャネルPlugin SDK
• 外部パッケージ: @tencent-weixin/OmeniaClaw-weixin