DingTalk

Deploy Mona as a DingTalk bot for enterprise messaging.

Prerequisites

• A working MonoClaw installation
• A DingTalk developer account
• An organization with admin access

1. Create a DingTalk app

1. Go to open.dingtalk.com
2. Click Create App → H5 Micro App
3. Fill in app information
4. Note the AgentId, AppKey, and AppSecret

2. Enable robot

1. In your app settings, go to Robot
2. Enable Robot Message Push
3. Set the webhook URL: https://your-domain.com/webhooks/dingtalk
4. Note the Robot Code

3. Configure MonoClaw

monoclaw gateway setup

Choose DingTalk and enter:

• App Key
• App Secret
• Robot Code

Or manually:

monoclaw config set DINGTALK_APP_KEY "your-app-key"
monoclaw config set DINGTALK_APP_SECRET "your-app-secret"
monoclaw config set DINGTALK_ROBOT_CODE "your-robot-code"

4. Start the gateway

monoclaw gateway start

Interaction

Group chats

Add the bot to a DingTalk group:

1. Go to group settings → Smart Assistants
2. Add your bot
3. @mention the bot to interact

@Mona summarize today's meeting notes

DMs

Search for the bot in DingTalk and send messages directly.

Configuration

gateway:
  dingtalk:
    app_key: "${DINGTALK_APP_KEY}"
    app_secret: "${DINGTALK_APP_SECRET}"
    robot_code: "${DINGTALK_ROBOT_CODE}"
    encrypt: true

Card messages

Mona can send rich card messages:

gateway:
  dingtalk:
    card_messages: true

Troubleshooting