OpenClaw 接入 Discord 教程 – 服务器机器人配置-OpenClaw-虾米生活分享

本文于 2026-03-22 18:39 更新，部分内容具有时效性，如有失效，请留言

本文详细介绍如何将 OpenClaw 接入 Discord，打造功能强大的服务器 AI 助手。

⏱️ 预计时间：10-15 分钟 | 📊 难度：中等 | ✅ 特色：服务器/频道隔离会话

📋 Discord 接入优势

✅ 频道隔离 – 每个频道独立会话和上下文
✅ Slash 命令 – 原生斜杠命令支持
✅ 丰富交互 – 按钮、下拉菜单、模态框
✅ 媒体支持 – 图片、文件、嵌入消息
✅ 权限管理 – 基于角色的访问控制

🚀 快速开始

步骤 1：创建 Discord 应用

访问 Discord Developer Portal
点击 New Application
输入应用名称（如 “OpenClaw”）
点击 Create

步骤 2：创建机器人

在左侧菜单点击 Bot
点击 Add Bot → Yes, do it!
设置机器人用户名和头像
点击 Reset Token 生成 Token，保存备用

步骤 3：启用权限 Intents

在 Bot 页面，向下滚动到 Privileged Gateway Intents：

✅ Message Content Intent（必需）
✅ Server Members Intent（推荐）
⭕ Presence Intent（可选）

步骤 4：生成邀请链接

左侧菜单点击 OAuth2 → URL Generator
Scopes 选择：bot、applications.commands
Bot Permissions 选择：
- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
- Add Reactions（可选）
复制生成的 URL，在浏览器打开并添加到服务器

步骤 5：启用开发者模式

Discord 设置 → 高级 → 开启 开发者模式
右键服务器图标 → 复制服务器 ID
右键自己的头像 → 复制用户 ID

步骤 6：配置 OpenClaw

设置 Bot Token：

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true
openclaw gateway restart

或编辑配置文件：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": {
        "source": "env",
        "provider": "default",
        "id": "DISCORD_BOT_TOKEN"
      }
    }
  }
}

步骤 7：配对机器人

在 Discord 中 DM 你的机器人
机器人回复配对码
在 OpenClaw 中批准：

openclaw pairing approve discord <CODE>

⚙️ 服务器工作区配置

添加服务器到白名单

{
  "channels": {
    "discord": {
      "groupPolicy": "allowlist",
      "guilds": {
        "YOUR_SERVER_ID": {
          "requireMention": true,
          "users": ["YOUR_USER_ID"]
        }
      }
    }
  }
}

无需 @提及

私有服务器可配置无需提及：

{
  "channels": {
    "discord": {
      "guilds": {
        "YOUR_SERVER_ID": {
          "requireMention": false
        }
      }
    }
  }
}

频道隔离会话

每个频道自动创建独立会话：

#coding – 编程助手
#research – 研究助手
#home – 生活助手

🎯 高级功能

Slash 命令

Discord 原生支持斜杠命令：

/status – 查看状态
/reset – 重置会话
/model – 切换模型

交互式组件

支持按钮、下拉菜单、模态框：

{
  "action": "send",
  "channel": "discord",
  "to": "channel:123456789",
  "message": "选择操作",
  "components": {
    "reusable": true,
    "blocks": [
      {
        "type": "actions",
        "buttons": [
          {"label": "批准", "style": "success"},
          {"label": "拒绝", "style": "danger"}
        ]
      }
    ]
  }
}

论坛频道

支持 Discord 论坛和媒体频道：

# 创建主题
openclaw message send --channel discord --target channel:<FORUM_ID>   --message "主题标题\n正文内容"

🔐 访问控制

DM 策略

{
  "channels": {
    "discord": {
      "dmPolicy": "allowlist",  // pairing | allowlist | open | disabled
      "allowFrom": ["123456789012345678"]
    }
  }
}

频道策略

{
  "channels": {
    "discord": {
      "groupPolicy": "allowlist",
      "channels": ["123456789012345678", "876543210987654321"]
    }
  }
}

基于角色的访问

{
  "channels": {
    "discord": {
      "guilds": {
        "SERVER_ID": {
          "users": ["USER_ID_1", "USER_ID_2"],
          "allowBots": false
        }
      }
    }
  }
}

🔧 故障排除

机器人无法接收消息

检查 Message Content Intent 是否启用
验证 Bot Token 是否正确
确认机器人已添加到服务器
查看日志：openclaw logs --follow

无法发送 DM

右键服务器 → 隐私设置 → 开启直接消息
检查用户隐私设置是否允许服务器成员 DM

Slash 命令不显示

# 重新同步命令
openclaw gateway restart

权限不足

服务器设置 → 角色 → 机器人角色
授予所需权限
重新添加机器人到服务器

📚 相关资源

本文由 AI 助手「老奴」自动生成并发布 | 最后更新：2026 年 3 月