Discord 集成

将 ClawdBot 添加到你的 Discord 服务器

概述

Discord 是一个流行的社区和团队协作平台。通过 ClawdBot 的 Discord 集成, 你可以在服务器中创建一个智能 AI 助手,帮助社区成员回答问题、管理任务等。

ClawdBot 使用 Discord Bot API,支持私信、频道消息、斜杠命令等功能。

创建 Discord 应用

步骤 1: 访问开发者门户

  1. 访问 Discord Developer Portal
  2. 登录你的 Discord 账号
  3. 点击 "New Application"
  4. 输入应用名称(例如:ClawdBot)

步骤 2: 创建 Bot

  1. 在左侧菜单点击 "Bot"
  2. 点击 "Add Bot"
  3. 确认创建

步骤 3: 获取 Token

  1. 在 Bot 页面点击 "Reset Token"
  2. 复制生成的 Token
  3. 请妥善保存,Token 只显示一次!

步骤 4: 配置权限

在 Bot 设置页面:

  • 开启 MESSAGE CONTENT INTENT
  • 开启 SERVER MEMBERS INTENT(可选)

配置 ClawdBot 连接

方法 1: 使用命令行

clawdbot discord setup

按提示输入 Bot Token。

方法 2: 使用配置文件

# ~/.clawdbot/config.yaml

channels:
  discord:
    enabled: true
    token: "YOUR_DISCORD_BOT_TOKEN"
    # 可选配置
    prefix: "!"  # 命令前缀
    allowed_guilds:  # 只在特定服务器响应
      - 123456789012345678

邀请 Bot 到服务器

生成邀请链接:

  1. 在开发者门户点击 "OAuth2" → "URL Generator"
  2. 选择 scopes: bot, applications.commands
  3. 选择权限(见下方权限设置)
  4. 复制生成的链接并访问
  5. 选择要添加的服务器

启动验证

# 重启 Gateway
clawdbot gateway restart

# 验证连接
clawdbot channels list

权限设置

推荐的 Bot 权限:

权限说明必需
Read Messages/View Channels读取频道消息
Send Messages发送消息
Embed Links发送富文本消息
Attach Files发送文件推荐
Read Message History读取历史消息推荐
Add Reactions添加表情反应可选
Use Slash Commands使用斜杠命令推荐

功能特性

支持的消息类型

  • 文本消息 - 普通对话
  • 嵌入消息 - 富文本卡片
  • 文件附件 - 图片和文件
  • 表情反应 - 消息反应

激活方式

在 Discord 中,ClawdBot 可以通过以下方式激活:

  • @mention - 在消息中 @ClawdBot
  • 私信 - 直接发送私信给 Bot
  • 斜杠命令 - 使用 /clawdbot 命令
  • 前缀命令 - 使用配置的前缀(如 !ask)

斜杠命令

/clawdbot ask [question] - 向 ClawdBot 提问
/clawdbot status - 查看状态
/clawdbot help - 显示帮助

故障排查

Bot 在线但不响应

  • 确认已开启 MESSAGE CONTENT INTENT
  • 检查 Bot 在该频道是否有权限
  • 尝试使用 @mention 或斜杠命令

无法邀请 Bot

  • 确认你有服务器的管理权限
  • 检查邀请链接的权限设置

斜杠命令不显示

  • 等待几分钟,Discord 同步需要时间
  • 确保邀请时选择了 applications.commands scope
  • 尝试重新邀请 Bot

查看日志

clawdbot logs --channel discord