Clawdbot Discord 集成指南

Clawdbot Discord 集成概述

Clawdbot Discord 集成让您可以使用官方 Discord 机器人网关将 AI 驱动的助手带入您的 Discord 服务器。这已准备好用于私聊和公会文本频道。

为什么选择 Clawdbot Discord？

Discord 是游戏和社区交流的领先平台。将 Clawdbot 与 Discord 集成可获得：

快速设置（初学者）

1. 创建 Discord 机器人并复制机器人 token
2. 在 Discord 应用设置中，启用 Message Content Intent（如果需要，还有 Server Members Intent）
3. 通过环境变量（DISCORD_BOT_TOKEN=...）或配置（channels.discord.token）设置 token
4. 使用消息权限邀请机器人到您的服务器
5. 启动网关
6. 私聊访问默认为配对模式；首次联系时批准配对码

最小配置：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

设置 Clawdbot Discord

前置条件

在将 Clawdbot 连接到 Discord 之前，请确保您已具备：

• 设备上已安装 Clawdbot
• 一个 Discord 账户
• Discord 开发者门户访问权限
• 服务器管理员权限

步骤 1：创建 Discord 应用

设置您的 Clawdbot Discord 应用：

1. 前往 Discord 开发者门户
2. 点击"新建应用"
3. 在您的应用中：Bot → 添加 Bot
4. 复制 Bot Token

步骤 2：启用网关 Intents

启用 Clawdbot 需要的 intents：

• Message Content Intent — 读取消息内容所需
• Server Members Intent — 白名单或名称查找所需

步骤 3：生成邀请 URL

在开发者门户中使用 OAuth2 URL 生成器：

Clawdbot Discord 所需权限：

• 读取消息/查看频道
• 发送消息
• 嵌入链接
• 读取消息历史
• 添加反应
• 使用斜杠命令

步骤 4：配置 Clawdbot Discord

将您的 Discord 机器人添加到 Clawdbot：

环境变量：

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

配置文件（~/.clawdbot/clawdbot.json）：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

如果同时设置了环境变量和配置，配置优先。

步骤 5：启动网关

clawdbot gateway --port 18789

当 token 可用且 channels.discord.enabled 不为 false 时，Discord 自动启动。

步骤 6：验证连接

检查您的 Clawdbot Discord 状态：

clawdbot channels status discord

工作原理

• 私聊折叠到代理的主会话（默认 agent:main:main）
• 公会频道保持隔离为 agent:<agentId>:discord:channel:<channelId>
• 群组私聊默认被忽略；通过 channels.discord.dm.groupEnabled 启用
• 路由是确定性的：回复始终返回到它们到达的频道

Clawdbot Discord 功能特性

私聊访问控制

私聊默认通过 channels.discord.dm.policy 安全：

示例（硬白名单）：

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

公会频道配置

设置每个公会或每个频道的规则：

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

斜杠命令

Clawdbot Discord 支持原生斜杠命令：

原生命令默认为 "auto"（Discord/Telegram 开启）。覆盖方式：

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

公会上下文历史

设置 channels.discord.historyLimit（默认 20）以在回复提及时包含最后 N 条公会消息作为上下文。设置 0 禁用。

反应

代理可以通过 discord 工具触发反应（由 channels.discord.actions.* 控制）。

Clawdbot Discord 配置

完整配置示例

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

配置写入

默认情况下，Discord 允许通过 /config set|unset 触发配置更新。禁用方式：

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

Clawdbot Discord 凭证存储

Clawdbot 安全存储 Discord 凭证：

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

您的 Clawdbot Discord 数据保留在本地机器上。

Clawdbot Discord 故障排除

机器人离线

如果 Clawdbot Discord 显示离线：

1. 验证 token：clawdbot channels verify discord
2. 检查网关连接
3. 查看日志：cat /tmp/clawdbot/discord.log

斜杠命令不工作

如果 Clawdbot Discord 斜杠命令失败：

1. 通过配置重新注册命令
2. 检查机器人权限
3. 验证服务器特定的命令注册

权限错误

如果 Clawdbot Discord 缺少权限：

1. 在服务器设置中检查机器人角色位置
2. 检查频道特定权限
3. 使用正确权限重新邀请

名称解析

名称 → id 解析使用公会成员搜索，需要 Server Members Intent。如果机器人无法搜索成员，使用 id 或 <@id> 提及。

Clawdbot Discord 最佳实践

1. 使用配对模式：私聊默认使用配对码确保安全
2. 设置频道限制：将 Clawdbot Discord 限制在适当的频道
3. 配置角色：为 Clawdbot Discord 使用基于角色的访问
4. 监控活动：定期查看 Clawdbot Discord 日志
5. 使用斜杠命令：比文本命令更好的用户体验

Clawdbot Discord 使用场景

社区支持

将 Clawdbot Discord 部署为支持机器人：

• 自动回答常见问题
• 升级复杂问题
• 提供全天候帮助

游戏社区

在游戏服务器中使用 Clawdbot Discord：

• 游戏信息查询
• 团队协调
• 活动安排

开发者社区

开发者服务器中的 Clawdbot Discord：

• 代码帮助
• 文档查询
• Bug 分类

下一步

• Clawdbot WhatsApp 集成 - 将 Clawdbot 连接到 WhatsApp
• Clawdbot Telegram 集成 - 在 Telegram 上设置 Clawdbot
• Clawdbot 设置指南 - 完整安装指南