📱

Chương 9: Kết Nối Telegram, Zalo, Discord

Trung Bình⏱ 15 phút đọc

9.1 Chat với AI ở mọi nơi

Thay vì mở web mỗi lần muốn hỏi AI, bạn kết nối OpenClaw với app chat yêu thích. Gửi tin nhắn trên Telegram → AI trả lời ngay trên Telegram. Tiện như nhắn tin cho bạn bè.

Bạn (Telegram/Zalo/Discord/WhatsApp/Slack) → OpenClaw 🦞 → AI Model → Trả lời ngay trên app

9.2 Kết nối Telegram (Phổ biến nhất ở VN)

4 bước đơn giản:

Bước 1: Mở Telegram, tìm @BotFather, gửi /newbot, đặt tên bot.

Bước 2: Copy token bot (dạng 123456:ABC-DEF...).

Bước 3: Thêm token vào cấu hình:

openclaw.json

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
      "allowedUsers": ["your_telegram_id"],
      "groupMode": false
    }
  }
}

Bước 4: Restart gateway và nhắn thử:

Khởi động lại

openclaw gateway restart
# Mở Telegram → nhắn cho bot "Xin chào!" → AI trả lời 🦞

💡 Mẹo bảo mật: Thêm 'allowedUsers' để chỉ bạn mới nói chuyện được với bot. Lấy ID bằng cách gửi /start cho @userinfobot.

9.3 Telegram nâng cao — Group & Channel

OpenClaw có thể hoạt động trong nhóm Telegram, trả lời khi được mention hoặc reply:

Cấu hình group mode

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "YOUR_BOT_TOKEN",
      "groupMode": true,
      "triggerOnMention": true,
      "triggerOnReply": true,
      "triggerPrefix": "/ai",
      "allowedGroups": ["-1001234567890"]
    }
  }
}

Tham số	Mô tả
`groupMode`	Bật chế độ nhóm, bot chỉ trả lời khi được gọi
`triggerOnMention`	Trả lời khi @mention bot
`triggerOnReply`	Trả lời khi reply tin nhắn của bot
`triggerPrefix`	Trả lời khi tin nhắn bắt đầu bằng /ai

9.4 Kết nối Discord

Discord phù hợp cho nhóm học tập, team dev, hoặc community. Bot có thể trả lời trong nhiều channel.

Bước 1: Vào discord.com/developers → New Application → Bot → Add Bot.

Bước 2: Bật MESSAGE CONTENT INTENT trong Bot settings.

Bước 3: OAuth2 → URL Generator → Chọn bot + Send Messages → Copy invite link.

Bước 4: Invite bot vào server, thêm config:

openclaw.json

{
  "channels": {
    "discord": {
      "enabled": true,
      "bot_token": "YOUR_DISCORD_BOT_TOKEN",
      "allowedChannels": ["general", "ai-chat"],
      "triggerOnMention": true,
      "triggerPrefix": "!ai"
    }
  }
}

Restart

openclaw gateway restart
# Vào Discord → Gõ: !ai Xin chào
# Hoặc: @OpenClaw Tóm tắt cuộc hội thoại

9.5 Kết nối Zalo (qua Webhook)

Zalo OA (Official Account) hỗ trợ webhook — phù hợp cho doanh nghiệp muốn chatbot chăm sóc khách hàng qua Zalo.

Bước 1: Tạo Zalo OA tại oa.zalo.me → Đăng ký tài khoản doanh nghiệp.

Bước 2: Vào Developer → Webhook → Thêm URL gateway của bạn.

Bước 3: Lấy OA ID và Secret Key từ dashboard.

openclaw.json

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oa_id": "YOUR_ZALO_OA_ID",
      "oa_secret": "YOUR_ZALO_OA_SECRET",
      "webhook_url": "https://your-server.com/webhook/zalo"
    }
  }
}

⚠️ Zalo OA yêu cầu server có IP công khai (public IP) hoặc domain. Không dùng được trên localhost. Nên deploy lên VPS hoặc dùng ngrok.

9.6 Kết nối WhatsApp

WhatsApp Business API cho phép kết nối OpenClaw với WhatsApp — phổ biến ở Việt Nam cho giao tiếp quốc tế.

Bước 1: Đăng ký Meta Business Suite → Tạo WhatsApp Business Account.

Bước 2: Vào developers.facebook.com → Tạo App → Chọn WhatsApp.

Bước 3: Lấy Phone Number ID, Access Token, Verify Token.

openclaw.json

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "phoneNumberId": "YOUR_PHONE_NUMBER_ID",
      "accessToken": "YOUR_ACCESS_TOKEN",
      "verifyToken": "YOUR_VERIFY_TOKEN",
      "webhookUrl": "https://your-server.com/webhook/whatsapp"
    }
  }
}

💡 WhatsApp có 1000 tin nhắn miễn phí/tháng. Đủ dùng cho cá nhân.

9.7 Kết nối Slack — Cho team công ty

Slack là lựa chọn tốt nhất cho team công ty. Mỗi thành viên có thể chat với AI ngay trong channel làm việc.

Bước 1: Vào api.slack.com → Create New App → From Scratch.

Bước 2: OAuth & Permissions → Thêm scopes: chat:write, app_mentions:read, channels:history.

Bước 3: Install to Workspace → Copy Bot Token.

Bước 4: Event Subscriptions → Bật → Thêm URL gateway.

openclaw.json

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-YOUR-SLACK-BOT-TOKEN",
      "signingSecret": "YOUR_SIGNING_SECRET",
      "appToken": "xapp-YOUR-APP-TOKEN",
      "allowedChannels": ["ai-assistant", "general"],
      "triggerOnMention": true,
      "threadReply": true
    }
  }
}

💡 Bật 'threadReply: true' để bot trả lời trong thread, không làm loãng conversation chính.

9.8 Web Chat — Embed vào website riêng

OpenClaw có widget chat có thể embed vào bất kỳ website nào — giống như Intercom hoặc Tidio nhưng miễn phí và dùng AI model bạn chọn.

Embed code (1 dòng)

<!-- Thêm vào trước </body> -->
<script src="https://your-server.com/widget.js"
  data-openclaw-url="https://your-server.com"
  data-theme="dark"
  data-position="bottom-right"
  data-title="Trợ lý AI 🦞"
></script>

openclaw.json

{
  "channels": {
    "web": {
      "enabled": true,
      "cors": ["https://your-website.com"],
      "widget": {
        "theme": "auto",
        "position": "bottom-right",
        "greeting": "Xin chào! Tôi có thể giúp gì cho bạn? 🦞",
        "placeholder": "Nhập câu hỏi..."
      }
    }
  }
}

Phù hợp: Landing page, blog, ecommerce — thay thế chatbot đắt tiền bằng AI thực sự.

9.9 Chạy nhiều kênh cùng lúc

OpenClaw chạy được TẤT CẢ kênh cùng lúc. Bạn nhắn trên Telegram, đồng nghiệp hỏi trên Slack, khách hàng chat trên website — cùng một AI, cùng một kho kiến thức.

Cấu hình đa kênh

// openclaw.json — Ví dụ chạy 4 kênh cùng lúc
{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "TG_TOKEN"
    },
    "discord": {
      "enabled": true,
      "bot_token": "DISCORD_TOKEN"
    },
    "slack": {
      "enabled": true,
      "botToken": "xoxb-SLACK_TOKEN"
    },
    "web": {
      "enabled": true,
      "cors": ["https://your-site.com"]
    }
  }
}

📊 Ví dụ thực tế:

📱 Telegram — Chat cá nhân hàng ngày
💬 Discord — Community support, nhóm học
💼 Slack — Team công ty, workflow nội bộ
🌐 Web — Khách hàng truy cập website

9.10 So sánh các kênh

Kênh	Độ khó setup	Cần server?	Group chat	Tốt nhất cho
Telegram	⭐ Đơn giản	Không	✅	Cá nhân, nhóm nhỏ
Discord	⭐⭐	Không	✅	Community, gamers
Zalo OA	⭐⭐⭐	Có (public IP)	❌	Doanh nghiệp VN
WhatsApp	⭐⭐⭐	Có (webhook)	✅	Quốc tế, business
Slack	⭐⭐	Không (Socket Mode)	✅	Team công ty
Web Chat	⭐	Có (gateway)	❌	Website, landing page
LINE	⭐⭐	Có (webhook)	✅	Nhật, Thái, Đài Loan

9.11 Xử lý sự cố kênh

Vấn đề	Nguyên nhân	Cách sửa
Bot không phản hồi	Gateway chưa chạy hoặc token sai	Kiểm tra: openclaw gateway status + kiểm tra token
Bot phản hồi rất chậm	Model AI chậm hoặc rate limited	Đổi sang model nhanh hơn (Gemini Flash, DeepSeek)
Bot phản hồi trong DM nhưng không trong group	Chưa bật groupMode	groupMode: true, triggerOnMention: true
Webhook không nhận được tin	URL webhook sai hoặc firewall chặn	Kiểm tra URL, mở port, dùng ngrok để test
Zalo OA không hoạt động	Chưa verify OA hoặc sai secret	Verify OA trên oa.zalo.me, kiểm tra secret key
Tin nhắn bị cắt ngắn	Vượt quá giới hạn ký tự của kênh	Giảm maxTokens trong config hoặc bật split_messages

Chẩn đoán kênh

# Kiểm tra trạng thái tất cả kênh
openclaw channels status

# Test kết nối từng kênh
openclaw channels test telegram
openclaw channels test discord

# Xem logs kết nối
openclaw logs --channel telegram --follow

# Restart một kênh cụ thể
openclaw channels restart telegram

9.12 Bảo mật & Quyền truy cập kênh

Quan trọng: Nếu không giới hạn quyền truy cập, bất kỳ ai biết bot cũng có thể chat — và dùng hết API credit của bạn!

Cơ chế	Mô tả
`allowedUsers`	Danh sách user ID được phép chat
`allowedGroups`	Danh sách group ID được phép
`rateLimit`	Giới hạn số tin nhắn/phút
`maxTokensPerUser`	Giới hạn token mỗi user/ngày

Cấu hình bảo mật

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "YOUR_TOKEN",
      "allowedUsers": ["123456789", "987654321"],
      "rateLimit": {
        "messagesPerMinute": 10,
        "maxTokensPerDay": 50000
      }
    }
  }
}

🎯 Tổng kết Chương 9

✅ Đã học được

Kết nối Telegram (cá nhân + group)
Setup Discord, Slack cho team
WhatsApp Business & Zalo OA
Web Chat — embed vào website
Chạy nhiều kênh cùng lúc
Bảo mật & giới hạn quyền truy cập

💡 Khuyên dùng cho người Việt

🥇 Telegram — Dễ nhất, miễn phí, cộng đồng lớn
🥈 Discord — Nhóm học, community
🥉 Zalo OA — Doanh nghiệp, CSKH
📌 Web Chat — Landing page, portfolio

Chương tiếp: Cấu hình nâng cao — tối ưu chi phí, multi-model, fallback ⚙️

←

Chương 8

Skills — 4000+ kỹ năng

Chương 11

Cấu hình nâng cao & tiết kiệm chi phí

→