OpenClaw集成Discord - 轻量应用服务器

本文介绍将 OpenClaw服务与Discord集成，实现在Discord中通过自然语言直接与OpenClaw交互。

环境准备

配置消息渠道前，需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器，若已完成可跳过此步骤。

购买并配置OpenClaw应用镜像的轻量应用服务器

步骤一、购买OpenClaw套餐

重要

如果已购买轻量应用服务器，可以跳过此步骤，以重置系统的方式部署OpenClaw（重置系统时选择应用镜像下的OpenClaw镜像），但重置系统会清除轻量应用服务器上的系统盘数据，请根据需要做好数据备份。具体操作，请参见重置系统。

购买预装OpenClaw应用的轻量应用服务器。
在轻量应用服务器页面，预置了资源配置，如要更改配置项，请参考下面内容。
- 实例：内存必须2GiB及以上，可以根据自己的需求切换套餐。
- 地域：默认美国（弗吉尼亚）。
  重要
  中国内地地域的服务器无法配置WhatsApp， Telegram，Discord，Slack等海外IM应用。
- 购买配置：默认12个月，可以根据自己的需求切换时长。

步骤二、配置OpenClaw

在轻量应用服务器-控制台，单击服务器卡片中的实例ID，在服务器概览页面单击应用详情页签。
在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw服务运行端口的防火墙。
重要
- 为了防止恶意扫描与定向攻击，OpenClaw 在初始化时不再使用固定的默认端口，而是自动生成一个随机端口，可在控制台查看OpenClaw的端口号。
- 端口放通将使服务暴露于公网，支持一键关闭 WebUI 公网访问，详见如何开启/关闭OpenClaw WebUI的公网访问？

单击配置OpenClaw下的执行命令配置百炼API key。

目前支持配置两种类型的百炼API Key：

Coding Plan 套餐专属 API Key（推荐）：采用固定月费模式，提供月度请求额度，超出时段限额的调用会报错且不计费用，可避免产生超出预期的费用。
Coding Plan 目前支持 qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型，详细的模型列表请参考Coding Plan概述。
按Token用量计费的百炼API Key。

API Key配置方式包括系统推荐及手动输入。系统推荐会列出百炼Coding Plan的API Key（成本可控），及离服务器最近的百炼模型服务的API Key（时延较低）。若需使用其他地域或者其他账号的API Key可选择手动输入。

系统推荐（下拉选择）

选择完成后单击下一步。

轻量应用服务器所在地域	系统推荐的百炼API Key对应地域	Coding Plan的API key对应地域
美国及欧洲地域	美国（弗吉尼亚）	新加坡
中国香港及其他亚洲地域	新加坡	新加坡

手动输入
单击按钮切换至手动输入，输入百炼API Key并选择该API Key对应地域，单击下一步。
重要
手动配置需确保选择的API Key对应地域正确，否则会导致模型无法正常调用。

单击访问Web UI面板下的获取地址，获取OpenClaw WebUI的地址，可以在Web页面与OpenClaw的Agent对话。
可根据需求参考关闭OpenClaw WebUI的公网访问一键关闭WebUI的公网访问权限。
（可选）查看Token。
在应用详情 > 基础配置 > 查看Token中单击查看，查看并保存Token。
警告
请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据，任何持有此链接的人都能直接绕过登录验证，获得 OpenClaw 控制台的管理员权限。

Discord准备

登录Discord开发者平台，点击New Application按钮，输入Discord Bot名称，同意条款后点击Create按钮进行创建。
进入Application页面，在左侧栏点击Bot，点击Reset Token生成新的 Token。
重要
点击确认后会生成一个 token，请妥善保存好勿对外泄露，后续在 OpenClaw 需要进行配置。
在Bot页面下滑到Privileged Gateway Intents，开启Message Content Intent，Server Members Intent，Presence Intent。点击下方Save Changes。
点击页面左侧的OAuth2，选择OAuth2 URL Generator。
1. 配置Scopes，建议先按照最小化原则勾选bot，applications.commands。
2. 配置Bot Permissions，勾选View Channels，Send Messages，Read Message History，Embed Links，Attach Files，Add Reactions。
在浏览器中打开页面底部生成的Generated URL，选择您希望添加 Bot 的 Discord 服务器。点击Continue后进行授权，即可邀请bot加入对应的Discord服务器。
重要
您需要拥有所选 Discord 服务器的管理员权限。

集成Discord

1. 在OpenClaw向导中配置Discord

访问轻量应用服务器控制台-服务器。
在服务器卡片中，单击远程连接。
在弹出的远程连接对话框中，选择Workbench一键连接，单击立即登录。
成功登录服务器后，输入如下命令，回车执行命令。
说明
接下来需要通过键盘来完成后续配置动作，可以通过键盘方向键控制选项，回车表示选择并确认。
```
openclaw onboard
```
运行上面的命令后，将会出现一个确认选项：是否知晓风险，选择Yes继续后续步骤。
配置Onboarding模式，选择QuickStart。
配置Config handling，选择Use existing values。
配置Model/auth provider，选择Skip for now -> All providers -> Keep current。
说明
如果前面步骤中已完成百炼API key配置，可以按照教程跳过此步骤。如果尚未进行模型配置，需要在此步通过命令行配置模型API Key。
接下来进入Select channel步骤，选择Discord (Bot API)。
输入前面步骤中保存的Discord bot token。
配置访问权限选择Yes。
访问权限模式选择Open (allow all channels)。
配置Skills，此处建议选择No，对于初次部署，限制权限可以提升稳定性和安全性。
启用 Hooks（若未出现此步骤，请忽略），推荐选择session-memory。
选择Restart重启使配置生效。
安装命令补全功能（若未出现此步骤，请忽略），推荐选择No。
重要
此处如果选择Yes，后续OpenClaw运行的时候容易导致服务器CPU负载高，使得OpenClaw运行出现问题。
完成以上步骤之后，系统将自动完成部署，待配置向导自动退出，返回命令行界面即为部署成功。

2. 测试机器人

在 Discord 服务器的联系人列表中点击前面步骤中添加的 Discord Bot 并发送第一条消息。
首次对话，会自动生成一个配对码。
远程连接轻量应用服务器后，输入并执行以下命令。
重要
需要将命令中的<code>替换为收到的Pairing code，输入时不加<>符号。
```
openclaw pairing approve discord <code>
```
成功完成 OpenClaw 接入 Discord。