Skip to main content
Connect DingTalk (钉钉) to your LemonClaw instance using Stream mode — a WebSocket-based connection that requires no public URL. This guide works for both hosted Claw instances and self-hosted LemonClaw deployments.

​
Prerequisites

​
Setup Guide

1

Create a DingTalk App

  1. Go to DingTalk Open Platform
  2. Click Application Development → Enterprise Internal Development
  3. Click Create Application
  4. Enter an app name and description
  5. Click Confirm
2

Enable Robot Capability

  1. In your app, go to App Features → Robot
  2. Enable the robot configuration
  3. Select Stream Mode (recommended — no public URL needed)
  4. Click Publish
Stream mode uses WebSocket, so your LemonClaw instance doesn’t need a publicly accessible webhook URL. This is the simplest setup.
3

Get Credentials

  1. Go to Basic Information → Credentials
  2. Copy the AppKey and AppSecret
4

Publish the App

  1. Go to Version Management
  2. Create a new version (at minimum a test version)
  3. Set the visible range (which users/departments can see the bot)
  4. Submit and publish
5

Open the LemonClaw WebUI

  1. If you’re using hosted Claw, go to your Claw Dashboard and click Open WebUI
  2. If you’re self-hosting LemonClaw, open your own WebUI (for example http://your-ip:18789) and sign in with your token
  3. In the WebUI, navigate to Settings → Channels
  4. Expand the DingTalk section
  5. Paste your AppKey and AppSecret
  6. Click Save
6

Start Chatting

  1. In DingTalk, search for your bot by name
  2. Send it a message
  3. The first user is automatically paired as the owner — no code needed!
  4. Start chatting with AI!

​
Group Behavior

Current LemonClaw DingTalk support is not a full group workbench integration yet.
  • Group messages only enter the AI flow when they @mention the bot
  • Replies prefer the original sessionWebhook conversation when available
  • Full group policy / allowlist / thread semantics are not available yet

​
Troubleshooting

Current LemonClaw DingTalk support is not a full group workbench integration yet. Group messages only enter the AI flow when they @mention the bot, and replies prefer the original session webhook.
  • Verify AppKey and AppSecret are correct
  • Check that the app is published (at least test version)
  • Make sure Stream mode is selected in the robot configuration
  • Verify the bot is visible to your user account
  • Stream mode maintains a persistent WebSocket connection
  • Brief disconnections are normal — the bot will auto-reconnect
  • If persistent, try restarting the instance from the dashboard