上一節講了掃碼直連的微信。這一節講另外兩個常用平臺：企微助理（需要開放平臺配置）和 QQ 機器人（掃碼直連）。一個面向企業團隊，一個面向 QQ 重度使用者。
一、企微助理接入#
企微助理對接的是企業微信，適合把 WorkBuddy 能力共享給整個團隊。和微信助理不同，它需要在企業微信的開放平臺建立應用，並配置回撥。
準備工作#
- 企業微信的管理員許可權（或請管理員協助）
- 一臺可被公網訪問的伺服器（用於接收回撥），或確認網路環境支援
- 拿到應用的 AppKey / AppSecret
配置步驟#
- 登入企業微信管理後臺，在"應用管理"裡建立一個自建應用
- 在應用設定裡配置回撥 URL（Callback URL），讓企業微信能把訊息推送給你的服務
- 記下應用的 AppKey / AppSecret
- 回到 WorkBuddy：進入 Claw 設定 → 選擇 "企微助理" → 點選 "配置"
- 把 AppKey / AppSecret 填入對應欄位
- 按提示完成回撥地址的繫結與驗證
驗證是否成功#
在企業微信裡找到剛建立的那個應用（通常會以機器人或助理的形態出現），給它發一句測試指令。電腦端 WorkBuddy 收到並響應，即說明對接成功。
回撥 URL 必須能被企業微信伺服器訪問到，所以你需要一臺公網伺服器。如果只在本地用，企微助理不是最佳選擇，可考慮飛書的 WebSocket 長連線方案。
二、QQ 機器人接入#
QQ 機器人屬於掃碼直連型，和微信助理一樣簡單，適合學生和 QQ 重度使用者。
準備工作#
- 一臺執行 WorkBuddy 的電腦
- 一個能正常登入的 QQ 帳號
配置步驟#
- 進入 WorkBuddy 的 Claw 設定
- 選擇 "QQ 機器人"，點選 "配置"
- 客戶端彈出二維碼
- 用手機 QQ 掃碼並確認授權
- 繫結成功後，QQ 裡會出現對應的 WorkBuddy 機器人
驗證是否成功#
在 QQ 裡找到剛繫結的 WorkBuddy 機器人，發一句"你好"測試。電腦端有響應即代表鏈路打通。
三、兩個平臺對比#
| 對比項 | 企微助理 | QQ 機器人 |
|---|---|---|
| 接入方式 | 開放平臺 + 回撥 | 掃碼直連 |
| 所需許可權 | 企業管理員 | 普通 QQ 帳號 |
| 是否要伺服器 | 是（公網回撥） | 否 |
| 適用物件 | 企業團隊 | 個人 / 學生 |
| 配置耗時 | 較長 | 幾分鐘 |
四、使用方式#
兩種平臺接入後的用法和微信一致——在 IM 裡發自然語言指令，電腦端執行後回傳結果。
幾個通用建議：
- 企業場景下，建議先由管理員在本地驗證好任務模板，再開放給同事使用
- QQ 場景下，同樣遵循"先本地後遠端"，新指令先在桌面端跑通
- 重要操作（刪除、批次改名、發訊息）遠端觸發前務必確認範圍
五、常見問題#
| 問題 | 解決辦法 |
|---|---|
| 企微回撥驗證失敗 | 檢查回撥 URL 是否公網可達、簽名是否正確 |
| 企微發指令無響應 | 確認 AppKey/AppSecret 填對、WorkBuddy 在執行 |
| QQ 掃碼失敗 | 換個網路重試，確認 QQ 帳號狀態正常 |
小結#
企微助理走開放平臺 + 回撥，適合企業團隊；QQ 機器人掃碼直連，適合個人。到這裡，IM 類平臺的主流接入方式就講完了。辦公平臺（飛書/釘釘）的接入思路和企微類似，可參照本章舉一反三。