前置條件
- 一個 WeCom 管理員帳號
- 一個 LemonClaw 實例:
- 託管型:建立一個 Claw 實例
- 自託管型:安裝 LemonClaw
設定指南
建立 WeCom 應用程式
- 登入 WeCom 管理後台
- 前往 應用管理 → 建立應用
- 輸入應用程式名稱、上傳標誌並設定可見範圍
- 點擊 建立
設定回呼 URL
- 在您的應用程式設定中,前往 接收訊息 → 設定 API 接收
- 對於託管型 Claw,當您展開 WeCom 區塊時,您的回呼 URL 會顯示在 LemonClaw WebUI 中:
- 對於自託管型 LemonClaw,請公開您自己的 HTTPS URL,並以
/webhook/wecom結尾 - 設定一個 Token (隨機字串) 與 EncodingAESKey (43 個字元的隨機字串)
- 點擊 儲存 — WeCom 將驗證回呼 URL
打開 LemonClaw WebUI
- 如果您使用的是託管型 Claw,請前往您的 Claw 控制面板 並點擊 Open WebUI
- 如果您是自託管 LemonClaw,請打開您自己的 WebUI (例如
http://your-ip:18789) 並使用您的 token 登入 - 在 WebUI 中,導覽至 Settings → Channels
- 展開 WeCom 區塊
- 如果您使用的是託管型 Claw,請複製頂部顯示的 Callback URL;如果您是自託管,請輸入您自己的公開 webhook URL
- 填寫:Corp ID、Corp Secret、Token、EncodingAESKey
- 點擊 Save
故障排除
目前 LemonClaw 的企業微信支援仍以使用者級 1:1 訊息為主,完整的群提及、執行緒與回覆語義尚未提供。
回呼 URL 驗證失敗
回呼 URL 驗證失敗
- 確保您的 LemonClaw 實例正在運行
- 驗證 URL 格式:
https://claw-{subdomain}.lemondata.cc/webhook/wecom - 在 WeCom 進行驗證 之前,檢查 Token 與 EncodingAESKey 是否已儲存在 LemonClaw 設定中
機器人沒有回應
機器人沒有回應
- 驗證 Corp ID 與 Corp Secret 是否正確
- 檢查應用程式對您的使用者帳號是否可見 (可見範圍設定)
- 確保 WeCom 與 LemonClaw 之間的 Token 與 EncodingAESKey 一致