Skip to main content
Integrate WeCom (企业微信 / WeChat Work) with your LemonClaw instance to bring AI to your enterprise workspace. This guide works for both hosted Claw instances and self-hosted LemonClaw deployments.

​
Prerequisites

​
Setup Guide

1

Create a WeCom App

  1. Log in to WeCom Admin Console
  2. Go to App Management → Create App
  3. Enter an app name, upload a logo, and set the visible range
  4. Click Create
2

Get Credentials

  1. Note your Corp ID — found at My Enterprise → Enterprise Info at the bottom
  2. In your app settings, copy the Secret (Corp Secret)
3

Configure Callback URL

  1. In your app settings, go to Receive Messages → Set API Receive
  2. For hosted Claw, your callback URL is displayed in the LemonClaw WebUI when you expand the WeCom section:
https://claw-{your-subdomain}.lemondata.cc/webhook/wecom
  1. For self-hosted LemonClaw, expose your own public HTTPS URL ending in /webhook/wecom
  2. Set a Token (random string) and EncodingAESKey (43-character random string)
  3. Click Save — WeCom will verify the callback URL
The hosted callback URL is shown in the LemonClaw WebUI with a copy button. Make sure your LemonClaw instance is running before verifying the URL.
4

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 WeCom section
  5. Copy the Callback URL shown at the top if you’re using hosted Claw, or enter your own public webhook URL if you’re self-hosting
  6. Fill in: Corp ID, Corp Secret, Token, EncodingAESKey
  7. Click Save
5

Start Chatting

  1. In WeCom, find your app in the Workbench
  2. Send a message to the app
  3. The AI will respond directly — no pairing needed for WeCom
The Token and EncodingAESKey must match exactly between the WeCom admin console and your LemonClaw configuration. A mismatch will cause message verification to fail.
Current LemonClaw WeCom support is user-scoped 1:1 messaging. Full group mention, thread, and reply semantics are not available yet.

​
Troubleshooting

Current LemonClaw WeCom support is user-scoped 1:1 messaging. Full group mention, thread, and reply semantics are not available yet.
  • Make sure your LemonClaw instance is running
  • Verify the URL format: https://claw-{subdomain}.lemondata.cc/webhook/wecom
  • Check that Token and EncodingAESKey are saved in LemonClaw config before verifying in WeCom
  • Verify Corp ID and Corp Secret are correct
  • Check that the app is visible to your user account (visible range setting)
  • Make sure Token and EncodingAESKey match between WeCom and LemonClaw