Openclaw Discord Setup

# OpenClaw Discord Setup

10 分钟配置 Discord Bot 作为 OpenClaw 消息渠道。

## 为什么选 Discord？

- **社区友好**：适合团队/社区运营
- **免费无限制**：消息、语音、文件全免费
- **功能丰富**：Slash 命令、按钮、Embeds
- **开发者生态**：完善的 API 和 SDK

## 快速配置

### Step 1: 创建 Discord 应用

1. 访问 https://discord.com/developers/applications
2. 点击 "New Application"
3. 设置名称（如 "My AI Assistant"）
4. 进入 "Bot" 页面，点击 "Add Bot"
5. 保存 **Token**

### Step 2: 邀请 Bot 到服务器

在 "OAuth2" > "URL Generator" 中：
- Scopes: `bot`, `applications.commands`
- Permissions: 
  - Send Messages
  - Read Messages
  - Use Slash Commands

复制生成的链接，在浏览器打开，选择服务器授权。

### Step 3: 配置 OpenClaw

编辑 `~/.openclaw/config.yaml`:

```yaml
plugins:
  entries:
    - plugin: openclaw-discord
      config:
        botToken: "YOUR_BOT_TOKEN"
        clientId: "YOUR_CLIENT_ID"
        allowedGuildIds:
          - "123456789"  # 服务器 ID
```

### Step 4: 启动 Gateway

```bash
openclaw gateway start
```

### Step 5: 测试

在 Discord 频道 @你的 Bot，应该收到 AI 回复。

## 高级功能

### Slash 命令

```yaml
plugins:
  entries:
    - plugin: openclaw-discord
      config:
        botToken: "xxx"
        slashCommands:
          - name: "ask"
            description: "Ask AI a question"
          - name: "clear"
            description: "Clear conversation history"
```

### 多服务器支持

```yaml
allowedGuildIds:
  - "123456789"
  - "987654321"
```

### 私信支持

```yaml
allowDM: true
```

### Embed 消息（更美观）

OpenClaw 会自动格式化回复为 Embed 样式。

## 常见问题

### Q: Bot 不响应
A: 检查 Bot Token 是否正确，确保 Bot 在服务器中

### Q: "Missing Access" 错误
A: 重新生成邀请链接，确保勾选了必要权限

### Q: Slash 命令不显示
A: 命令注册需要时间（最多 1 小时），或重启 Gateway

### Q: 如何获取服务器 ID？
A: Discord 设置 > 高级 > 开发者模式，然后右键服务器 > 复制 ID

## 成本

- Discord Bot API：**完全免费**
- OpenClaw Gateway：本地运行，无费用
- AI 模型：按使用量计费

## 安全建议

1. **不要**公开 Bot Token
2. 定期重新生成 Token
3. 只允许信任的服务器 ID
4. 在生产环境使用环境变量

```bash
export DISCORD_BOT_TOKEN="your-token-here"
```

## 需要帮助？

- 微信：yanghu_ai
- Telegram: @yanghu_openclaw
- 免费远程配置（首次）

---

Version: 1.0.0
Created: 2026-03-21