跳轉到主要內容
使用串流模式 (Stream mode) 將釘釘 (DingTalk) 連接至您的 LemonClaw 實例 — 這是一種基於 WebSocket 的連接方式，不需要公開的 URL。本指南適用於託管的 Claw 實例和自託管的 LemonClaw 部署。

​
先決條件

​
設定指南

1

建立 DingTalk 應用程式

  1. 前往 釘釘開放平台
  2. 點擊 應用開發 → 企業內部開發
  3. 點擊 創建應用
  4. 輸入應用程式名稱和描述
  5. 點擊 確定
2

啟用機器人功能

  1. 在您的應用程式中，前往 應用能力 → 機器人
  2. 啟用機器人配置
  3. 選擇 串流模式 (Stream Mode)（推薦 — 不需要公開 URL）
  4. 點擊 發佈
串流模式使用 WebSocket，因此您的 LemonClaw 實例不需要公開可存取的 webhook URL。這是最簡單的設定方式。
3

獲取憑據

  1. 前往 基礎資訊 → 憑據資訊
  2. 複製 AppKey 和 AppSecret
4

發佈應用程式

  1. 前往 版本管理與發佈
  2. 建立新版本（至少為測試版本）
  3. 設定可見範圍（哪些使用者/部門可以看到機器人）
  4. 提交並發佈
5

開啟 LemonClaw WebUI

  1. 如果您使用的是託管版 Claw，請前往您的 Claw Dashboard 並點擊 Open WebUI
  2. 如果您是自託管 LemonClaw，請開啟您自己的 WebUI（例如 http://your-ip:18789）並使用您的 token 登入
  3. 在 WebUI 中，導覽至 Settings → Channels
  4. 展開 DingTalk 區塊
  5. 貼上您的 AppKey 和 AppSecret
  6. 點擊 Save
6

開始對話

  1. 在 DingTalk 中，按名稱搜尋您的機器人
  2. 向它發送訊息
  3. 第一個使用者將 自動配對 為所有者 — 無需任何代碼！
  4. 開始與 AI 對話！

​
群組設定

在 LemonClaw WebUI 的 Channels 設定中配置群聊行為：
設定選項描述
Group PolicyOpen (預設) / Allowlist / Disabled控制誰可以在群組中觸發機器人
Group Allowed Users使用者 ID 列表僅這些使用者可以觸發機器人（allowlist 模式）
DingTalk 始終需要 @提及 (@mention) 才能在群組中觸發機器人 — 這是平台限制，無法配置。DingTalk 不支援群組 ID 過濾；請使用 Group Policy 設定來控制存取權限。

​
故障排除

目前 LemonClaw 的釘釘支援還不是完整的群工作台整合。群訊息只有在 @ 提及機器人時才會進入 AI 處理鏈，回覆會優先走原 sessionWebhook 會話。
  • 驗證 AppKey 和 AppSecret 是否正確
  • 檢查應用程式是否已發佈（至少為測試版本）
  • 確保在機器人配置中選擇了串流模式 (Stream mode)
  • 驗證機器人對您的使用者帳號是否可見
  • 串流模式維持持久的 WebSocket 連接
  • 短暫的斷開是正常的 — 機器人會自動重新連接
  • 如果問題持續存在，請嘗試從控制面板重啟實例