玩转 Clawdbot 接入 Discord 保姆级教程玩转 Clawdbot 接入 Discord 保姆级教程前言

玩转 Clawdbot 接入 Discord 保姆级教程

前言

Clawdbot（原 Moltbot）是一款强大的 AI 助手框架，支持通过插件扩展各种功能。本文将详细介绍如何将 Clawdbot 接入 Discord，实现通过 Discord 频道或私聊与 AI 助手交互。

本教程的核心是使用 clawdbot-discord-proxy 插件，该插件支持通过代理连接 Discord，特别适合大陆地区用户。

一、前置准备

已部署 Clawdbot 的云服务器（Node.js ≥ 22，已安装 Clawdbot）
Discord 账号（注册地址）
云服务器已配置海外代理（能访问 Discord API）

二、安装 clawdbot-discord-proxy 插件

# 1. 克隆项目
git clone https://github.com/Terendelev/clawdbot-discord-proxy.git
cd clawdbot-discord-proxy

# 2. 安装依赖并编译
npm install
npm run build

# 3. 复制到 Clawdbot 插件目录
cp -r ./ ~/.clawdbot/extensions/clawdbot-discord-proxy/

# 4. 重启 Gateway //如果失败请先复制配置文件
clawdbot gateway restart

三、创建 Discord Bot

打开 Discord 开发者平台
点击 New Application，输入 Bot 名称（如 Clawdbot-AI）
点击左侧 Bot → Add Bot，确认创建 Bot
复制 Token（点击 Reset Token 生成，妥善保存）
开启关键权限：
- MESSAGE CONTENT INTENT（读取消息内容）
- SERVER MEMBERS INTENT（可选）

四、配置 Bot 权限

左侧点击 OAuth2 → URL Generator
勾选权限：
- Scopes: bot + applications.commands
- Bot Permissions: Send Messages, Read Message History, Embed Links, Use Slash Commands
复制生成的 Invite Link，在浏览器打开，将 Bot 邀请到服务器

五、配置 Clawdbot

编辑 ~/.clawdbot/clawdbot.json：

{
  "channels": {
    "clawdbot-discord-proxy": {
      "accounts": {
        "default": {
          "token": "YOUR_DISCORD_BOT_TOKEN",
          "enabled": true,
          "name": "Clawdbot Discord"
        }
      },
      "proxyConfig": {
        "httpUrl": "http://PROXY_IP:HTTP_PORT",
        "httpsUrl": "http://PROXY_IP:HTTP_PORT",
        "wsUrl": "socks5://PROXY_IP:SOCKS_PORT",
        "wssUrl": "socks5://PROXY_IP:SOCKS_PORT",
        "noProxy": ["localhost", "127.0.0.1"]
      },
      "pluralkit": {
        "enabled": true
      }
    }
  },
  "plugins": {
    "entries": {
      "clawdbot-discord-proxy": {
        "enabled": true
      }
    }
  }
}

配置说明

配置项	说明
`token`	Discord Bot Token
`httpUrl` / `httpsUrl`	HTTP/HTTPS 代理地址
`wsUrl` / `wssUrl`	SOCKS5 代理地址
`pluralkit.enabled`	是否启用 PluralKit 支持

六、启动 Gateway

clawdbot gateway  restart

七、功能特性

WebSocket Gateway - 通过代理连接 Discord 实时网关
REST API - 完整的 Discord REST API 封装
代理支持 - HTTP/HTTPS 和 SOCKS5 代理
PluralKit 支持 - 自动识别代理消息

八、常见问题

1. Gateway 连接超时

检查 SOCKS5 代理是否正常运行
验证 Bot Token 是否有效
确保防火墙允许 WebSocket 连接

2. 消息发送失败

检查 Bot 是否有发送消息权限
确认目标用户已有与 Bot 的 DM 频道
查看日志：tail -50 /tmp/clawdbot/clawdbot-*.log

3. 代理配置不生效

确认代理地址和端口正确
检查 noProxy 列表是否包含必要地址

九、相关链接

本文由 Clawdbot 社区贡献