WecomTeam/wecom-openclaw-plugin
OpenClaw 的官方企业微信插件,由企业微信团队开发和维护。它将你的 OpenClaw Agent 无缝对接到企业微信工作流,集成文档、智能表格、日历能力。
WeCom OpenClaw プラグイン – 速報
何であるか – OpenClaw AIエージェントフレームワークが WeCom(騰訊のエンタープライズWeChat)と通信できる最初の公式チャネルプラグインです。WeComユーザーとの通信を2通り提供します:
| モード | 接続方法 | 一般的な用途 |
|---|---|---|
| Bot | WebSocketの長時間ポーリング または HTTP Webhook(JSON) | 高速でストリーミング返信、設定が簡単。 |
| Agent | HTTP Webhookコールバック(XML、AES-256-CBC暗号化) | 企業向け、API駆動型のメッセージ送信。 |
このプラグインには、数十のWeComビジネスAPI(メッセージ、メール、ドキュメント、スプレッドシート、カレンダー、会議、ファイルストレージ、連絡先など)を「スキル」としてAIが呼び出せるようにする、wecom-cli コマンドラインツールも同梱されています。
主な機能(READMEに記載)
- 二重モード動作 – BotとAgentは並行して動作可能。出力メッセージにはBotが優先され、WebSocketがダウンした場合はAgentにフォールバック。
- メッセージ形式 – テキスト、Markdown、画像、動画、音声、ファイル、および「图文混排」の混合メッセージに対応。音声メッセージは自動的に文字起こし。
- プロアクティブメッセージ – ユーザーの入力待ちではなく、特定のユーザー、グループ、部署、タグにメッセージをプッシュ可能。
- ストリーミング返信 – LLMが思考中の間、「思考中」のプレースホルダーメッセージを送信可能(Botモードのみ)。
- アクセス制御 – ダイレクトメッセージ(ペアリング、オープン、許可リスト、無効化)とグループチャットの細かいポリシー、アカウントごとのコマンド権限。
- 複数アカウント対応 – 1つのOpenClawゲートウェイで複数のWeComアカウントを運用可能。各アカウントに独自のBot/Agent設定。
- 動的エージェント – セッション分離のため、ユーザーまたはグループごとにオプションで独立したエージェントを設定可能。
- メディア処理 – 入力メディアの自動ダウンロード、サイズ制限(画像・動画:10MB、音声:2MB)、制限を超えた場合は自動的にファイル形式に変換。
- 組み込みビジネススキル –
wecom-cliで以下のコマンドが利用可能:- メッセージ、メール、ドキュメント・スプレッドシートのCRUD
- スマートシート・スマートドキュメント管理
- Todo、カレンダー、会議スケジューリング、議事録・会議記録
- WeDriveファイル検索/アップロード/ダウンロード
- 連絡先検索
- CLIウィザード –
openclaw channels addまたは@wecom/wecom-openclaw-cli installで、Bot ID/Secretの入力と設定をガイド付きで実行可能。 - 堅牢なネットワーク – ハートビート、再接続ロジック、キック防止、オプションのエグレッションプロキシ。
セットアップ手順(READMEより)
- 前提条件 – OpenClaw ≥ 2026.3.28。
- インストール – 1行で実行可能:
npx -y @wecom/wecom-openclaw-cli install # 必要に応じて --force を追加 - 設定 –
openclaw channels add(インタラクティブ)を実行するか、直接キーを設定。例:openclaw config set channels.wecom.botId <BOT_ID> openclaw config set channels.wecom.secret <BOT_SECRET> openclaw config set channels.wecom.enabled true openclaw gateway restart - ビジネスツールの有効化 –
tools.alsoAllowにプラグインIDを追加し、ゲートウェイを再起動。 - モード選択 – デフォルトのWebSocketによるBotモード、またはCorpID/Secret、AgentId、Token、EncodingAESKeyを設定し、WeCom管理コンソールでコールバックURLを登録してAgentモードを選択。
どんな人が使うべきか?
- 既にOpenClawベースのAIアシスタントを運用している企業で、それらをWeComチャット内に表示させたい人。
- プロアクティブ通知、リッチメディア処理、WeComのドキュメント・カレンダー・会議APIを呼び出したい開発者。
- クロンで定期的に部署やタグにブロードキャストを送信したい運用チーム。
制限事項と注意点(ドキュメントより)
- BotモードにはBot IDとSecretが必要。Agentモードには企業アプリ(CorpID/Secret)とXML暗号化コールバックが必要。
- 制限サイズを超えるメディアはファイルとして送信されるか、拒否される。
- Agent専用アカウントを使用する場合、WeComコンソールにコールバックURLを保存する前にAgentを設定しておく必要がある(WeComはURLを即座に検証する)。
- プラグインバージョンはOpenClawバージョンと一致している必要がある(例:OpenClaw 2026.3.22 → プラグイン 2026.3.20;新しいOpenClaw → プラグイン 2026.3.24+)。
まとめ(TL;DR)
WeCom OpenClaw プラグインは、生産環境対応のブリッジで、OpenClaw AIエージェントが騰訊のエンタープライズWeChatと通信できるようにし、リッチメディア、プロアクティブメッセージ、WeComビジネスAPIのフルセットを便利なCLI経由で利用可能。WebSocket(Bot)または暗号化XML Webhook(Agent)モードで動作し、複数アカウントに対応。アクセスポリシー、モード間の自動フォールバックなど、安全機能も搭載。
関連
- プロジェクト
- Dispatch
- プロジェクト
- プロジェクト