【OpenClaw】——小龙虾极简接入Discord教程

📖 前言:OpenClaw 原生支持 Discord,无需插件。虽配置略繁琐,但其全平台体验极佳,且频道机制极其强大,每个频道可独立设置 Prompt 和模型,不同频道间的上下文互不干扰。本文手把手带你在 Discord 部署你的全能 AI 助理。


目录

  • [🕒 1. 前置工作](#🕒 1. 前置工作)
  • [🕒 2. 创建Discord服务器(可选)](#🕒 2. 创建Discord服务器(可选))
  • [🕒 3. 创建Discord应用](#🕒 3. 创建Discord应用)
  • [🕒 4. 给应用配置机器人](#🕒 4. 给应用配置机器人)
  • [🕒 5. 配置Channel](#🕒 5. 配置Channel)
  • [🕒 6. Discord优化](#🕒 6. Discord优化)
    • [🕘 6.1 频道必须@才能回复](#🕘 6.1 频道必须@才能回复)
    • [🕘 6.2 流式输出](#🕘 6.2 流式输出)
  • [🕒 7. 疑难解答](#🕒 7. 疑难解答)

🕒 1. 前置工作

  • OpenClaw:已经配置好可正常使用
  • Discord账号:注册可正常使用
  • 代理环境

🕒 2. 创建Discord服务器(可选)

如果你已有服务器可跳过。没有的话,打开 Discord 桌面端,点击左侧"+"号:选择"亲自创建"→"仅供我和我的朋友使用",输入名称即可快速完成创建。

个人使用的话,建议独自新建一个服务器,与他人共用服务器的话,要严格限制好Token用量。

🕒 3. 创建Discord应用

🔎 Discord开发者平台官网

打开开发者平台网站,点击New Application按钮,输入Discord Bot名称(如OpenClaw-AI),同意条款后点击Create按钮进行创建。

🕒 4. 给应用配置机器人

创建应用后,在左侧菜单点击 "Bot",接着点击 "Reset Token" 获取密钥,记得立即复制并保存好,后续配置会用到。

页面往下滑到Privileged Gateway Intents区域,依次开启图示三个选项:Message Content Intent(必选,读取消息内容)、Server Members Intent (推荐选择,角色允许列表和名称与ID匹配时需要使用)、Presence Intent (可选,仅用于状态更新)。

勾选后点击下方Save Changes保存。

在左侧菜单点击 OAuth2,随后滑动到 OAuth2 URL Generator 区域,先配置Scopes,建议先按照最小化原则勾选

  • bot
  • applications.commands

继续往下滚动,在 Bot Permissions 中勾选:

  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach
  • Files
  • Add Reactions

复制页面底部生成的链接 (Generated URL), 并在浏览器打开。在弹窗中选择目标服务器(需管理员权限),点击继续并完成授权,即可将 Bot 成功邀请进服务器。


🕒 5. 配置Channel

打开Openclaw控制台,在 openclaw.json 中编辑如下配置信息,将前面生成的token填入。

bash 复制代码
{
  channels: {
    discord: {
      enabled: true,
      token: "YOUR_BOT_TOKEN",
    },
  },
}

配置完成后,重启Openclaw网关

bash 复制代码
openclaw gateway restart

找到这个 Bot ,私信它任意内容,进入配对模式

打开SSH,将配对码填充至如下指令,发送给Openclaw所在的虚拟机:

bash 复制代码
openclaw pairing approve discord xxxxxx

再次重启网关,然后在频道里 @它,就能看到回复啦

🕒 6. Discord优化

🕘 6.1 频道必须@才能回复

默认情况下,Bot 仅在被 @提及 时才会回复(防止误触发)。

若需实现免@ 自动回复,可参考如下配置。false表示免@ 即可回复

bash 复制代码
"channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "groupPolicy": "open",
      "requireMention": true,
      "guilds": {
        "148016029xxxxxxxxxx": {
          "requireMention": false
        }
      }
    }
  },

外层配置为全局策略,内层配置则覆盖特定服务器(需匹配服务器ID)

获取方式:用户设置 → 高级设置 → 打开开发者模式

随后右键服务器图标 → 复制服务器ID

🕘 6.2 流式输出

🔎 Openclaw 实时推送优化实战:告别"等半天才回复"的尴尬

可参考上文按需配置,我的参考配置如下:

bash 复制代码
"agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
      },
      "blockStreamingDefault": "on",
      "blockStreamingBreak": "text_end",
      "blockStreamingChunk": {
        "minChars": 200,
        "maxChars": 1500,
        "breakPreference": "sentence"
      },
      "blockStreamingCoalesce": {
        "minChars": 200,
        "maxChars": 1500,
        "idleMs": 600
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
"channels": {
    "discord": {
      "enabled": true,
      "streaming": "block",
      "blockStreaming": true,
      "token": "YOUR_BOT_TOKEN",
    }
  },

🕒 7. 疑难解答

问题:无论在频道(@与否)还是私信,Bot都不输出任何内容

排查思路:输入如下指令,检查discord的配置状态

bash 复制代码
openclaw health

如果为 configured,代表仅仅是配置好,但还没有和 Discord 服务器通信。

需按照如下配置设置好代理:

bash 复制代码
"channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "proxy": "http://192.168.xx.xx:7892",
    }
  },

如果看到 ok,代表通信正常,此时可以去聊天了。


OK,以上就是本期知识点"小龙虾极简接入Discord教程"的知识啦~~ ,感谢友友们的阅读。后续还会继续更新,欢迎持续关注哟📌~

💫如果有错误❌,欢迎批评指正呀👀~让我们一起相互进步🚀

🎉如果觉得收获满满,可以点点赞👍支持一下哟~

❗ 转载请注明出处

作者:HinsCoder

博客链接:🔎 作者博客主页

相关推荐
Database_Cool_2 小时前
OpenClaw-Observability:基于 DuckDB 构建 OpenClaw 的全链路可观测体系
数据库·阿里云·ai
集丰照明3 小时前
使用宝塔安装OpenClaw 龙虾教程
ai·宝塔·龙虾
XLYcmy3 小时前
一个针对医疗RAG系统的数据窃取攻击工具
python·网络安全·ai·llm·agent·rag·ai安全
wb043072013 小时前
使用 Java 开发 MCP 服务并发布到 Maven 中央仓库完整指南
java·开发语言·spring boot·ai·maven
ipython_harley4 小时前
【AGI】OpenAI核心贡献者翁家翌:修Infra的人,正在定义GPT-5
人工智能·gpt·ai·agi
周周爱喝粥呀5 小时前
词元ID是如何转为嵌入向量? 位置嵌入的作用是什么?
人工智能·ai
AI周红伟5 小时前
OpenClaw是什么?OpenClaw能做什么?OpenClaw详细介绍及保姆级部署教程-周红伟
大数据·运维·服务器·人工智能·微信·openclaw
tianbaolc7 小时前
Claude Code 源码剖析 模块一 · 第六节:autoDream 自动记忆整合
人工智能·ai·架构·claude code
AI大模型..7 小时前
数据洞察加速器:LLM Copilot 如何让 SQL 查询效率提升 50% 以上?
人工智能·langchain·llm·agent·llama
大写-凌祁8 小时前
从 Chain-of-Thought 到 Self-Consistency:大模型推理能力是如何被“解锁”的?
人工智能·语言模型·自然语言处理·agent·智能体