Integrate ZeroClaw with messaging channels

1. Create a DingTalk app

1. Create a Lark application

1. Go to the Lark Open Platform, click Create Custom App, enter an application name and description, select an icon, and then click Create.

2. In the navigation pane on the left, click Credentials & Basic Info. Copy the App ID (in the format cli_xxx) and App Secret.

3. In the navigation pane on the left, click Permissions Management. Click Bulk Import/Export Permissions, paste the permission JSON configuration, click Next, Confirm New Permissions, and then click Request to Enable.

   JSON configuration file content

   {
     "scopes": {
       "tenant": [
         "aily:file:read",
         "aily:file:write",
         "application:application.app_message_stats.overview:readonly",
         "application:application:self_manage",
         "application:bot.menu:write",
         "cardkit:card:write",
         "contact:user.employee_id:readonly",
         "corehr:file:download",
         "docs:document.content:read",
         "event:ip_list",
         "im:chat",
         "im:chat.access_event.bot_p2p_chat:read",
         "im:chat.members:bot_access",
         "im:message",
         "im:message.group_at_msg:readonly",
         "im:message.group_msg",
         "im:message.p2p_msg:readonly",
         "im:message:readonly",
         "im:message:send_as_bot",
         "im:resource",
         "sheets:spreadsheet",
         "wiki:wiki:readonly"
       ],
       "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
     }
   }

4. In the navigation pane on the left, click Add App Features. Click the Add by Feature tab, find the Bot card, and then click Configure.

5. Configure event subscriptions.

   1. In the Simple Application Server console, go to the details page of the target instance. In the Application Details > Channel Configuration > Lark section, enter the App ID and App Secret that you obtained, and then click Apply.

   2. In the Lark Open Platform, click Events & Callbacks in the navigation pane on the left. On the Event Configuration tab, click Subscription Method, select Use persistent connection to receive events, and then click Save.

   3. On the Event Configuration page, click Add Event, search for the im.message.receive_v1 (Receive Message) event, and then click Confirm Add.

6. On the Version Management & Release page, create a version. Enter the App Version and Update Notes, click Save, and then submit for review and release.

2. Configure the bot

You can add the bot to a new or existing group chat. To test the bot, mention it with @bot in a Lark group, or search for it and start a private chat.

To use the bot in an external group, see the document Bots support external groups and one-on-one chats with external users.

1. Add the bot by choosing ... > Settings > Group Bots > Add Bot.

2. Click the bot's avatar and then click Send Message to send a private message to the bot.