Merge remote-tracking branch 'origin/main' into shared/rewards-center-integration

Author: lefarcen

docs/.vitepress/config.ts

@@ -113,8 +113,11 @@ const enSidebar = [
         text: "Channel Configuration",
         link: "/guide/channels",
         items: [
+          { text: "WeCom", link: "/guide/channels/wecom" },
           { text: "WeChat", link: "/guide/channels/wechat" },
           { text: "Feishu", link: "/guide/channels/feishu" },
+          { text: "QQ", link: "/guide/channels/qq" },
+          { text: "DingTalk", link: "/guide/channels/dingtalk" },
           { text: "Slack", link: "/guide/channels/slack" },
           { text: "Discord", link: "/guide/channels/discord" },
           { text: "Telegram", link: "/guide/channels/telegram" },
@@ -161,7 +164,10 @@ const jaSidebar = [
         text: "チャンネル設定",
         link: "/ja/guide/channels",
         items: [
+          { text: "WeCom", link: "/ja/guide/channels/wecom" },
           { text: "Feishu", link: "/ja/guide/channels/feishu" },
+          { text: "QQ", link: "/ja/guide/channels/qq" },
+          { text: "DingTalk", link: "/ja/guide/channels/dingtalk" },
           { text: "Slack", link: "/ja/guide/channels/slack" },
           { text: "Discord", link: "/ja/guide/channels/discord" },
           { text: "Telegram", link: "/ja/guide/channels/telegram" },
@@ -209,7 +215,10 @@ const zhSidebar = [
         link: "/zh/guide/channels",
         items: [
           { text: "微信", link: "/zh/guide/channels/wechat" },
+          { text: "企业微信", link: "/zh/guide/channels/wecom" },
           { text: "飞书", link: "/zh/guide/channels/feishu" },
+          { text: "QQ", link: "/zh/guide/channels/qq" },
+          { text: "钉钉", link: "/zh/guide/channels/dingtalk" },
           { text: "Slack", link: "/zh/guide/channels/slack" },
           { text: "Discord", link: "/zh/guide/channels/discord" },
           { text: "Telegram", link: "/zh/guide/channels/telegram" },

docs/en/guide/channels.md

@@ -4,7 +4,10 @@ nexu supports connecting multiple chat channels at the same time. Just enter the
 
 Click one of the links below for a detailed setup guide:
 
+- [WeCom](/guide/channels/wecom) 🆕
 - [Feishu](/guide/channels/feishu)
+- [QQ](/guide/channels/qq) 🆕
+- [DingTalk](/guide/channels/dingtalk) 🆕
 - [Slack](/guide/channels/slack)
 - [Discord](/guide/channels/discord)
 - [WeChat](/guide/channels/wechat)

docs/en/guide/channels/dingtalk.md

@@ -0,0 +1,116 @@
+# DingTalk
+
+All you need is a Client ID and Client Secret to connect your DingTalk bot to nexu.
+
+## Step 1: Open the DingTalk channel in nexu
+
+1. Open the nexu client and click **DingTalk** in the Channels section.
+
+![Choose DingTalk in nexu](/assets/dingtalk/step7-choose-dingtalk-channel.webp)
+
+2. Open the DingTalk developer platform: https://open.dingtalk.com/
+
+![Open the DingTalk platform from nexu](/assets/dingtalk/step7-open-platform-link.webp)
+
+## Step 2: Sign in to the DingTalk developer platform
+
+1. Use the DingTalk app to scan the login QR code.
+
+![DingTalk developer platform login QR](/assets/dingtalk/step1-login-qr.webp)
+
+## Step 3: Create a DingTalk app
+
+1. After signing in, go to the app development guide page and click "Create App".
+
+![Create app entry on the home page](/assets/dingtalk/step2-home-create-entry.webp)
+
+2. On the app development page, click "Create App" in the upper-right corner.
+
+![Create DingTalk app entry](/assets/dingtalk/step2-create-app.webp)
+
+3. Fill in the app name, description, and icon, then click "Save".
+
+![Fill in app name and description](/assets/dingtalk/step2-fill-app-info.webp)
+
+## Step 4: Add bot capability to the app
+
+1. Open the app details page, go to "Add App Capability", and click "Add" on the Bot card.
+
+![Add bot capability](/assets/dingtalk/step3-add-bot-capability.webp)
+
+2. Open the "Bot" page on the left and turn on bot configuration.
+
+![Enable bot configuration](/assets/dingtalk/step3-enable-bot.webp)
+
+3. Complete the bot name, profile, avatar, language settings, and receive mode, then click "Publish" at the bottom.
+
+![Fill in the bot configuration and publish](/assets/dingtalk/step3-bot-config-form.webp)
+
+## Step 5: Grant the required permissions
+
+Open "Permission Management" on the left and apply for the permissions nexu needs.
+
+For a smoother AI chat experience, we recommend enabling these AI Card permissions:
+
+- **Card.Instance.Write** - AI Card write permission
+- **Card.Streaming.Write** - AI Card streaming output permission
+
+Tips:
+
+- With AI Card enabled, replies appear progressively like ChatGPT
+- Without it, the bot still works, but replies are sent as normal text messages
+
+The screenshot below shows the page for enabling `Card.Instance.Write`.
+
+![Grant card-related permissions](/assets/dingtalk/step4-permission-card-write.webp)
+
+## Step 6: Copy the Client ID and Client Secret
+
+Go back to the credentials page and copy these two values:
+
+- **Client ID**
+- **Client Secret**
+
+![Copy Client ID and Client Secret](/assets/dingtalk/step5-copy-credentials.webp)
+
+## Step 7: Create and publish a version
+
+1. Open "Version Management & Release" on the left, then click "Create New Version" in the empty version list.
+
+![Open the version management page](/assets/dingtalk/step6-version-list.webp)
+
+2. Fill in the version number, release notes, and visibility scope, then save.
+
+![Create a new version](/assets/dingtalk/step6-create-version.webp)
+
+3. Complete the DingTalk publishing flow so the bot can go live.
+
+## Step 8: Connect DingTalk in nexu
+
+1. Paste the Client ID and Client Secret into the DingTalk channel dialog in nexu, then click "Connect DingTalk".
+
+![Connect DingTalk in nexu](/assets/dingtalk/step7-nexu-connect.webp)
+
+2. Once connected, open DingTalk and start chatting with the bot.
+
+![Bot chat working in DingTalk](/assets/dingtalk/step8-chat-success.webp)
+
+---
+
+## FAQ
+
+**Q: Why isn't it enough to only create the app?**
+
+A DingTalk bot usually also needs bot capability enabled, permissions granted, and a published version. Missing any of these can stop the bot from working.
+
+**Q: Do I need a public server?**
+
+No. With nexu's current DingTalk integration, you usually do not need to host your own public callback service.
+
+**Q: Why can't my teammates see the app after publishing?**
+
+Check the visibility scope you configured during version publishing and make sure the correct users or departments are included.
+
+**Q: Why is the bot not replying?**
+
+Check the Client ID and Client Secret first, then confirm the bot capability is enabled, permissions are granted, the version is published, and the nexu client is still running.

docs/en/guide/channels/qq.md

@@ -0,0 +1,80 @@
+# QQ
+
+All you need is an App ID and App Secret to connect your QQ bot to nexu.
+
+## Step 1: Open the QQ channel in nexu
+
+1. Open the nexu client and click **QQ** in the Channels section.
+
+![Choose QQ in nexu](/assets/qq/step3-choose-qq-channel.webp)
+
+2. Open the QQ Open Platform: https://q.qq.com/qqbot/openclaw/login.html
+
+![Open the QQ platform from nexu](/assets/qq/step3-open-platform-link.webp)
+
+## Step 2: Sign in to the QQ Open Platform
+
+1. Use mobile QQ to scan the login QR code.
+
+![QQ Open Platform login QR](/assets/qq/step1-login-qr.webp)
+
+2. Tap "Agree" in mobile QQ to finish signing in.
+
+![Confirm login in mobile QQ](/assets/qq/step1-login-confirm.webp)
+
+## Step 3: Create a QQ bot
+
+1. After signing in, click "Create Bot" in the bot list.
+
+![Create a QQ bot](/assets/qq/step1-create-bot.webp)
+
+## Step 4: Copy the App ID and App Secret
+
+![Bot detail entry](/assets/qq/step2-create-bot.webp)
+
+Copy and save these two values from the bot details page:
+
+- **App ID**
+- **App Secret**
+
+The full App Secret may only be shown once, so save it right away.
+
+## Step 5: Connect QQ in nexu
+
+Paste the App ID and App Secret into the QQ channel dialog in nexu, then click "Connect QQ".
+
+![Connect QQ in nexu](/assets/qq/step3-nexu-connect.webp)
+
+## Step 6: Start chatting in QQ
+
+Once connected, open desktop QQ or mobile QQ, find the bot conversation you just created, and send a message to start chatting with your Agent.
+
+![Chat with the Agent in QQ](/assets/qq/step4-chat.webp)
+
+---
+
+## FAQ
+
+**Q: Do I need my own server or a public callback URL?**
+
+No. With nexu's current QQ integration, you only need to enter the App ID and App Secret in the client.
+
+**Q: Where do I find the QQ bot after it's connected?**
+
+Open desktop QQ or mobile QQ and search for the bot name you used when creating it, or look for it in your recent conversations.
+
+**Q: Why is the bot not replying even though the connection succeeded?**
+
+Check these first:
+
+- The App ID and App Secret are entered correctly
+- The nexu client is still running
+- You are messaging the exact bot you just created
+
+**Q: Will the bot keep replying if my computer is turned off?**
+
+The nexu client needs to stay running. As long as nexu is running in the background and your computer is not asleep, the bot can keep replying.
+
+**Q: Can I add the bot to a QQ group?**
+
+Yes. You can add the bot to a QQ group and use it there. It is still a good idea to test the bot in a private chat first.

docs/en/guide/channels/wecom.md

@@ -0,0 +1,109 @@
+# WeCom
+
+Using the Intelligent Bot feature inside the WeCom client, you only need to copy the `Bot ID` and `Secret` to connect WeCom to nexu.
+
+## Prerequisites
+
+- If you are already part of a WeCom organization, you need enterprise admin permission in that organization to create and use an intelligent bot.
+- If you are an individual user, you can register your own WeCom account first. Personal registration is free and does not require business credentials.
+
+## Step 1: Open Intelligent Bot and start creating
+
+1. Open the nexu client and click **WeCom** in the Channels section.
+
+![Choose WeCom in nexu](/assets/wecom/step0-choose-wecom-channel.webp)
+
+2. In the WeCom client, click "Workbench" in the left sidebar, switch to "Smart Office" at the top, then open "Intelligent Bot".
+
+![Open the Intelligent Bot page](/assets/wecom/step1-open-workbench.webp)
+
+3. On the Intelligent Bot page, click "Create Bot".
+
+![Click Create Bot](/assets/wecom/step2-create-bot-entry.webp)
+
+4. In the creation dialog, click "Manual Create" in the lower-left corner.
+
+![Choose Manual Create](/assets/wecom/step3-manual-create.webp)
+
+## Step 2: Switch to API mode and copy credentials
+
+1. On the creation page, click "Create in API Mode" on the right.
+
+![Switch to API mode](/assets/wecom/step4-api-mode.webp)
+
+2. In API settings, choose "Use Long Connection".
+
+3. Copy and save these two values:
+   - **Bot ID**
+   - **Secret**
+
+You will need them when connecting WeCom in nexu.
+
+![Choose long connection and copy Bot ID and Secret](/assets/wecom/step5-copy-botid-secret.webp)
+
+## Step 3: Grant permissions
+
+1. On the same page, scroll down to "Available Permissions" and click the expand button on the right.
+
+![Open the permissions panel](/assets/wecom/step6-open-permissions.webp)
+
+2. In the permissions dialog, click "Authorize All".
+
+![Authorize all permissions](/assets/wecom/step7-authorize-all.webp)
+
+## Step 4: Finish the bot configuration and save
+
+1. Back on the bot settings page, confirm or adjust the visibility scope so you or the intended members can see and use the bot.
+
+![Set the visibility scope](/assets/wecom/step8-visible-range.webp)
+
+2. If needed, edit the bot avatar, name, and description, then click "Confirm".
+
+![Edit bot information](/assets/wecom/step9-edit-bot-info.webp)
+
+3. After confirming the settings, click "Save" at the bottom.
+
+![Save the bot configuration](/assets/wecom/step10-save-bot.webp)
+
+## Step 5: Open the bot and start using it
+
+1. After saving, click "Use Now" on the bot details page.
+
+![Open the bot details page](/assets/wecom/step11-use-bot.webp)
+
+2. Go back to nexu, paste the `Bot ID` and `Secret` into the WeCom channel dialog, then click "Connect WeCom".
+
+![Enter Bot ID and Secret in nexu](/assets/wecom/step12-nexu-connect.webp)
+
+3. In Contacts or in the bot list, find the bot you just created and click "Send Message".
+
+![Open the bot conversation](/assets/wecom/step12-send-message.webp)
+
+4. Once connected, you can chat with your Agent in WeCom like this.
+
+![Chat with the bot in WeCom](/assets/wecom/step13-chat.webp)
+
+---
+
+## FAQ
+
+**Q: Can I use this if I am not an enterprise admin?**
+
+Yes. If you are not an admin in an existing organization, you can register your own WeCom account first and create the intelligent bot yourself.
+
+**Q: Do I need my own server or public callback URL?**
+
+No. If you choose "Use Long Connection" in this flow, you do not need to configure your own public callback address.
+
+**Q: Why is the bot not replying after I connected it?**
+
+Check these first:
+
+- The `Bot ID` and `Secret` in nexu are correct
+- Permissions in WeCom have been granted
+- The visibility scope includes you
+- The nexu client is still running
+
+**Q: Can I add this bot to a group chat?**
+
+Yes. It is best to confirm that the bot works in a 1:1 chat first, then add it to a WeCom group chat.

docs/ja/guide/channels.md

@@ -4,7 +4,10 @@ nexu は複数のチャットチャンネルを同時にサポートします。
 
 以下のリンクから詳細なセットアップガイドをご覧ください：
 
+- [WeCom](/ja/guide/channels/wecom) 🆕
 - [Feishu](/ja/guide/channels/feishu)
+- [QQ](/ja/guide/channels/qq) 🆕
+- [DingTalk](/ja/guide/channels/dingtalk) 🆕
 - [Slack](/ja/guide/channels/slack)
 - [Discord](/ja/guide/channels/discord)
 - [Telegram](/ja/guide/channels/telegram) 🆕