渠道集成概述

Clawdbot 通过网关集成多种消息平台，让你可以在一个地方管理所有的 AI 助手交互。

支持的渠道

Clawdbot 支持 20+ 消息平台:

渠道	协议/库	状态
WhatsApp	Baileys	✅ 完全支持
Telegram	grammY	✅ 完全支持
Discord	discord.js	✅ 完全支持
Slack	Bolt SDK	✅ 完全支持
Signal	signal-cli	✅ 完全支持
iMessage	imsg (macOS)	✅ 完全支持
Matrix	matrix-js-sdk	✅ 完全支持
Mattermost	插件	✅ 完全支持
Google Chat	API	✅ 完全支持
Microsoft Teams	Bot Framework	✅ 完全支持

快速配置

启用渠道

运行引导向导选择要启用的渠道:

clawdbot onboard

或手动编辑配置:

{
  channels: {
    whatsapp: { enabled: true },
    telegram: { enabled: true },
    discord: { enabled: true }
  }
}

渠道登录

# 登录 WhatsApp (扫描二维码)
clawdbot channels login whatsapp
 
# 登录 Telegram (输入 Bot Token)
clawdbot channels login telegram
 
# 登录 Discord (输入 Bot Token)
clawdbot channels login discord

共同配置选项

所有渠道共享以下配置选项:

私聊策略 (dmPolicy)

{
  channels: {
    whatsapp: {
      // 配对模式 - 未知用户需要配对码
      dmPolicy: "pairing",
 
      // 白名单模式 - 只允许列表中的用户
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
 
      // 开放模式 - 允许所有用户
      dmPolicy: "open",
 
      // 禁用 - 不处理私聊
      dmPolicy: "disabled"
    }
  }
}

群聊策略 (groupPolicy)

{
  channels: {
    telegram: {
      // 开放 - 处理所有群组消息
      groupPolicy: "open",
 
      // 白名单 - 只处理指定群组
      groupPolicy: "allowlist",
      allowGroups: ["123456789"],
 
      // 禁用
      groupPolicy: "disabled"
    }
  }
}

提及要求 (requireMention)

{
  channels: {
    discord: {
      groups: {
        "*": {
          // 需要 @提及 才响应
          requireMention: true
        }
      }
    }
  }
}

渠道功能对比

功能	WhatsApp	Telegram	Discord	Slack
流式传输	✅	✅	✅	✅
反应	✅	✅	✅	✅
编辑消息	❌	✅	✅	✅
内联按钮	✅	✅	✅	✅
语音笔记	✅	✅	❌	❌
文件分享	✅	✅	✅	✅

多渠道运行

渠道可以同时运行:

{
  channels: {
    whatsapp: { enabled: true },
    telegram: { enabled: true },
    discord: { enabled: true },
    slack: { enabled: true }
  }
}

Clawdbot 会根据每个聊天的来源自动路由消息。

渠道状态检查

# 查看所有渠道状态
clawdbot channels status
 
# 查看特定渠道
clawdbot channels status whatsapp

故障排除

常见问题

连接失败: 检查网络和认证凭据
消息不响应: 确认 DM/群组策略配置正确
权限问题: 检查 Bot 权限设置

诊断命令

# 运行诊断
clawdbot doctor
 
# 查看日志
clawdbot logs --channel whatsapp --follow

下一步

选择你要配置的渠道:

远程访问 WhatsApp