[Telegram/Openclaw] Configure openclaw bot in a Telegram group.

Step 1: Create a New Bot on Telegram via BotFather

Đầu tiên bạn vào father bot và tạo telegram bot.

Step 2: Add the New Bot Token to OpenClaw Config

Khi đã có token thì bạn vào file openclaw.json

Bạn cần enable telegram bằng true

{
  ...
  
  "channels": {
    "telegram": {
      "enabled": true,
      ...
      
      "accounts": {
        ...
        ,
        "new-bot": {
          "dmPolicy": "pairing",
          "botToken": "__OPENCLAW_REDACTED__",
          "groupPolicy": "open",
          "streaming": "partial"
        }
      }
      

{
  ...
  
  "channels": {
    "telegram": {
      "enabled": true,
      ...
      
      "accounts": {
        ...
        ,
        "new-bot": {
          "dmPolicy": "pairing",
          "botToken": "__OPENCLAW_REDACTED__",
          "groupPolicy": "open",
          "streaming": "partial"
        }
      }
      

Bạn sẽ add config new-bot giữ nguyên các config: dmPolicy, groupPolicy, streaming

dmPolicy: Kiểm soát người có thể nhắn tin riêng cho bot này (chat 1-1). Thường có 3 lựa chọn:
– “pairing“: Người lạ nhận được mã ghép đôi; bạn phải phê duyệt qua openclaw pairing approve telegram <MÃ>
– “allowlist“: Chỉ những ID người dùng được phê duyệt trước (trong allowFrom) mới có thể nhắn tin trực tiếp cho bot
– “open“: Bất kỳ ai cũng có thể nhắn tin trực tiếp cho bot mà không cần phê duyệt.

"pairing" is the safest default — it prevents unauthorized people from accessing your agent

groupPolicy: Kiểm soát những nhóm Telegram mà bot này được phép hoạt động. Các lựa chọn:
– “open“: Bot trả lời trong mọi nhóm mà nó được thêm vào.
– “allowlist“: Bot chỉ trả lời trong các nhóm được liệt kê rõ ràng trong channels.telegram.groups

streaming: Kiểm soát cách agent truyền tải phản hồi của nó trở lại Telegram. Các tùy chọn:
– “partial“: Bot gửi phản hồi một cách tuần tự khi nó tạo ra (giống như đang gõ trực tiếp) — trải nghiệm người dùng tốt nhất.
– “full“: Bot đợi cho đến khi có phản hồi đầy đủ, sau đó gửi tất cả cùng một lúc.
– “off“: Tắt hoàn toàn tính năng streaming

Step 3: Create or Assign an Agent for the New Bot

bạn muốn một tác nhân chuyên dụng mới:

openclaw agents add my-new-agent

Sau đó, hãy thêm một liên kết để ánh xạ accountId → agentId trong cấu hình của bạn:

bindings: [
  { agentId: "main",         match: { channel: "telegram", accountId: "default" } },
  ...
  { agentId: "my-new-agent", match: { channel: "telegram", accountId: "newbot" } } // ← NEW
]

Step 4: Restart Gateway & Approve Pairing

Khởi động lại OpenClaw để áp dụng cấu hình mới:

openclaw gateway

Sau đó DM bot mới của bạn trên Telegram. Nó sẽ trả lời bằng một mã ghép nối. Hãy chấp thuận nó:

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Step 5: Verify Everything Is Working

openclaw agents list --bindings
openclaw channels status