openclawdc

openclawdc

一键配置 Discord 与 OpenClaw 的连接。

快速开始

npx openclawdc

或指定 Bot Token：

# macOS/Linux
DISCORD_BOT_TOKEN="你的Token" npx openclawdc

# Windows PowerShell
$env:DISCORD_BOT_TOKEN="你的Token"; npx openclawdc

# Windows CMD
set DISCORD_BOT_TOKEN=你的Token && npx openclawdc

前置条件

• 已安装 OpenClaw：npm install -g openclaw && openclaw onboard
• 已创建 Discord 应用和机器人

Discord 开发者平台设置

1. 创建应用

• 访问 Discord Developer Portal
• 点击 New Application
• 输入应用名称（如：OpenClaw Bot）

2. 添加机器人

• 左侧菜单点击 Bot
• 点击 Add Bot
• 点击 Reset Token 并复制 Token

3. 启用 Message Content Intent（必须）

在 Bot 页面，找到 Privileged Gateway Intents：

• ✅ MESSAGE CONTENT INTENT - 必须启用

4. 配置权限

在 OAuth2 → URL Generator：

Scopes:

• ✅ bot

Bot Permissions:

• ✅ Send Messages
• ✅ Read Messages/View Channels
• ✅ Read Message History
• ✅ Embed Links（推荐）
• ✅ Attach Files（推荐）

5. 邀请机器人

复制生成的 URL，在浏览器中打开，选择服务器并授权。

配置项

配置项	说明	必要性
token	Discord Bot Token	必填
enabled	是否启用	必填
allowlist	允许的用户 ID 列表	可选

手动配置

如果自动配置失败，可以手动执行：

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.token "YOUR_BOT_TOKEN"
openclaw config set channels.discord.allowlist '["USER_ID_1", "USER_ID_2"]'
openclaw gateway restart

常用命令

# 查看状态
openclaw channels status --deep

# 查看日志
openclaw channels logs

# 重启服务
openclaw gateway restart

故障排除

机器人不响应

• 检查 MESSAGE CONTENT INTENT 是否已启用
• 检查机器人是否在服务器中
• 检查机器人是否有读取消息的权限
• 查看日志：openclaw channels logs

Token 无效

• 在 Discord Developer Portal 重新生成 Token
• 重新运行配置：npx openclawdc

权限不足

确保机器人有以下权限：

• Send Messages
• Read Messages/View Channels
• Read Message History

License

MIT