本文记录了我优化 OpenClaw + Discord 推送体验的完整过程，从”等半天发一大段”到”实时逐字显示”，以及消息已读回执的配置技巧。

一、问题背景：为什么你的 AI 回复显得很”low”

1.1 原始体验的痛点

在使用 OpenClaw + Discord 的过程中，你是否遇到过这种情况：

  • 你给 AI 发了个问题
  • 等待 30 秒… 1 分钟… 甚至更久
  • 突然，一大段文字”砰”地砸到脸上
  • 你甚至不知道 AI 到底有没有在读你的消息

这种体验就像是：

你给朋友发微信，对方不显示”正在输入”，过了 5 分钟突然发来一篇小作文

1.2 技术原因

默认配置下，OpenClaw 的行为是：

  1. 接收用户消息
  2. Agent 开始生成完整回复
  3. 等全部生成完毕
  4. 一次性发送到 Discord

对于长内容（比如 2000 字的技术文章），这意味着用户要干等几十秒。

二、解决方案：Block Streaming + Ack Reaction

OpenClaw 提供了两种机制来优化体验：

2.1 Block Streaming（分块流式输出）

让 AI 边生成边发送，而不是等全部写完。

原理：

1
2
3
4
5
6
7
8
9
10
11
用户提问
    ↓
AI 开始生成内容
    ↓
满 50 字符 ──→ 立即发送第一块
    ↓
继续生成
    ↓
空闲 200ms ──→ 发送第二块
    ↓
...直到完成

用户感受：

  • AI 秒回（第一块几乎立即到达）
  • 内容像打字机一样逐行出现
  • 等待时间从”几十秒”缩短到”毫秒”

2.2 Ack Reaction（消息已读回执）

Discord 的”小眼睛”功能，让用户知道 AI 已读消息。

效果：

  • 用户发消息后，消息上出现 👀 小眼睛
  • 表示 Bot 已经看到并正在处理
  • 减少用户的焦虑等待感

三、配置详解

3.1 Block Streaming 核心参数（优化后）

经过实际测试，流式但不碎片的最佳配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "agents": {
    "defaults": {
      "blockStreamingDefault": "on",
      "blockStreamingBreak": "text_end",
      "blockStreamingChunk": {
        "minChars": 200,
        "maxChars": 1500,
        "breakPreference": "sentence"
      },
      "blockStreamingCoalesce": {
        "minChars": 200,
        "maxChars": 1500,
        "idleMs": 600
      }
    }
  }
}

参数解析：

参数 说明 调优建议
minChars 至少积累多少字符才发送第一块 200 是流式和连贯的平衡点。太小（如1）会碎成单句，太大（如1000）响应慢
maxChars 单块上限，超过强制分割 1500 是 Discord 安全线（接近 2000 字符限制）
breakPreference 在哪里断开消息 sentence 在句号处断，保护句子完整性；paragraph 段落太长
idleMs 空闲多久后发送已积累的内容 600ms 给用户阅读时间，太短（100ms）会切得太碎

⚠️ 避坑指南：

配置 效果 是否推荐
minChars: 1 + idleMs: 100 秒回但碎片严重，每个句子单独发 ❌ 不推荐
minChars: 200 + idleMs: 600 流式且连贯，段落感强 ✅ 推荐
minChars: 1000 + idleMs: 1200 响应慢，接近整段发送 ⚠️ 失去流式感

关键优化点：

1. 平衡响应速度与连贯性（minChars: 200）

不是越小越好！minChars: 1 会导致每个句子都单独发送，看起来很碎。200 字符大约是 2-3 句话，既有流式感又不会碎片化：

1
2
3
[00:00] 用户：帮我写篇文章
[00:00] AI：好的，我来帮你写这篇文章。主题是关于...
[00:01] AI：首先我们需要确定文章结构，然后...

2. 代码块保护（breakPreference: sentence）

避免代码被分割到多条消息：

1
2
3
4
5
// ❌ 原来可能在代码中间断开
"breakPreference": "newline"

// ✅ 现在在句子边界断开，保护代码完整性
"breakPreference": "sentence"

3. 给用户阅读时间（idleMs: 600）

不是越快越好！100ms 会导致内容像机关枪一样蹦出来，用户来不及看。600ms 让内容有节奏地出现，阅读体验更好。

3.2 主动进度推送（进阶优化）

除了自动分块，还可以在任务中主动发送进度：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
【AI日报任务 - 带进度推送】

**Step 1: 前置检查**
- 检查今日文章是否已存在
- **发送进度**: "🔄 AI日报任务开始..."

**Step 2: 研究阶段**
- 搜索AI热点新闻
- **进度 20%**: "📰 已获取 12 条热点"
- **进度 40%**: "📊 筛选出 Top 5 重要事件"

**Step 3: 配图阶段**
- **进度 60%**: "🎨 封面图已生成"

**Step 4: 撰写阶段**
- **进度 80%**: "📝 文章撰写中..."

**Step 5: 发布阶段**
- **进度 100%**: "✅ AI日报已发布！"

效果： 用户能看到完整的任务执行流程，不再”黑盒等待”。

3.2 Discord 频道配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "channels": {
    "discord": {
      "enabled": true,
      "streaming": "block",
      "accounts": {
        "default": {
          "token": "YOUR_BOT_TOKEN",
          "streaming": "block",
          "blockStreaming": true
        }
      }
    }
  }
}

关键点：

  • streaming: "block" - 启用分块模式
  • blockStreaming: true - 明确开启块流式

3.3 消息已读回执配置

1
2
3
4
5
{
  "messages": {
    "ackReactionScope": "all"
  }
}

选项对比：

值 效果
"none" 不显示已读回执
"group-mentions" 仅当被 @ 时显示
"all" 所有消息都显示 👀

四、完整配置示例

以下是我的多 Agent Discord 机器人的完整配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "kimi-code/kimi-for-coding"
      },
      "workspace": "/root/.openclaw/workspace",
      "maxConcurrent": 4,
      
      "// Block Streaming 配置": "实时推送核心 - 流式但不碎片",
      "blockStreamingDefault": "on",
      "blockStreamingBreak": "text_end",
      "blockStreamingChunk": {
        "minChars": 200,
        "maxChars": 1500,
        "breakPreference": "sentence"
      },
      "blockStreamingCoalesce": {
        "minChars": 200,
        "maxChars": 1500,
        "idleMs": 600
      }
    },
    "list": [
      { "id": "main" },
      { "id": "forge" },
      { "id": "muse" },
      { "id": "vitality" },
      { "id": "sigma" }
    ]
  },
  
  "channels": {
    "discord": {
      "enabled": true,
      "groupPolicy": "allowlist",
      "streaming": "block",
      "accounts": {
        "default": {
          "token": "CYPHER_BOT_TOKEN",
          "streaming": "block",
          "blockStreaming": true,
          "guilds": {
            "GUILD_ID": {
              "channels": {
                "🎯-指挥台": {
                  "allow": true,
                  "requireMention": false
                }
              }
            }
          }
        },
        "forge": {
          "token": "FORGE_BOT_TOKEN",
          "streaming": "block",
          "blockStreaming": true
        },
        "muse": {
          "token": "MUSE_BOT_TOKEN",
          "streaming": "block",
          "blockStreaming": true
        },
        "vitality": {
          "token": "VITALITY_BOT_TOKEN",
          "streaming": "block",
          "blockStreaming": true
        },
        "sigma": {
          "token": "SIGMA_BOT_TOKEN",
          "streaming": "block",
          "blockStreaming": true
        }
      }
    }
  },
  
  "messages": {
    "ackReactionScope": "all"
  }
}

五、效果对比

5.1 优化前

1
2
3
4
5
6
[00:00] 用户：帮我写个 Python 脚本
[00:45] AI：【突然弹出 2000 字长文】
        ...
        ...
        ...
        （用户：你倒是吱一声啊！）

问题：

  • 不知道 AI 是否在处理
  • 长内容要等很久
  • 体验像在和树洞对话

5.2 优化后

1
2
3
4
5
6
7
8
9
10
[00:00] 用户：帮我写个 Python 脚本
[00:00] 👀 小眼睛出现（已读）
[00:01] AI：好的，这是一个 Python 脚本
[00:02] AI：可以实现文件批量重命名功能
[00:04] AI：
        ```python
        import os
[00:05] AI：def rename_files():
[00:07] AI：    for filename in os.listdir('.'):
[00:09] AI：        ...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

**改进：**
- 👀 小眼睛秒出现（已读确认）
- 内容实时逐行显示
- 用户感知到"AI 在认真工作"

## 六、常见问题

### 6.1 消息太多太碎？

**问题现象：** 每个句子都单独发送，看起来像刷屏。

**原因：** `minChars` 太小（如 1）或 `idleMs` 太短（如 100）。

**解决方案：**
```json
"minChars": 200,    // 至少攒够 200 字符（约 2-3 句话）
"idleMs": 600       // 等待 600ms 让内容积累

效果： 消息以段落为单位出现，既有流式感又不会碎片化。

6.2 代码块被分割？

使用 "breakPreference": "sentence"，在句子边界分割，保护代码块完整性。

如果代码特别长，可以添加自定义规则检测代码围栏：

1
2
3
"blockStreamingChunk": {
  "codeFenceAware": true  // 检测 ``` 标记，不内部分割
}

6.3 首句还是慢？

确保 minChars 设置为 1，并且 blockStreamingBreak 为 "text_end"。

6.4 看不到执行步骤？

在定时任务 prompt 中加入主动进度推送：

1
2
3
4
**每完成一个阶段，立即发送进度：**
- **进度 20%**: "研究阶段完成"
- **进度 40%**: "数据整理完成"
- ...

6.5 小眼睛不显示？

检查：

  1. Bot 有 Add Reactions 权限
  2. ackReactionScope 设置为 "all"
  3. Gateway 已重启

七、总结

通过 Block Streaming + Ack Reaction + 主动进度推送 的组合，OpenClaw + Discord 的体验可以从”树洞式”进化为”对话式”：

维度 优化前 优化后（推荐配置）
响应延迟 几十秒 毫秒级
首句延迟 等50字符 200字符快速响应
消息连贯性 整块砸脸 段落式流式
代码保护 可能断裂 句子边界分割
进度可见 黑盒等待 每20%推送
用户体验 焦虑等待 实时反馈
感知智能 迟钝 敏捷
专业度 显得 low 显得高级

核心优化公式（实测版）

1
2
3
4
5
流式不碎片 = minChars: 200（2-3句话一块）
           + breakPreference: sentence（句子边界）
           + idleMs: 600（600ms节奏感）
           + ackReactionScope: all（已读确认）
           + 主动进度推送（过程可见）

避坑提醒：

  • ❌ minChars: 1 + idleMs: 100 = 碎片化严重，像刷屏
  • ✅ minChars: 200 + idleMs: 600 = 流式连贯，阅读舒适

让你的 AI 助手不再像”过气聊天机器人”，而是像真正的智能助理一样，秒回首句、逐字显示、代码完整、进度透明、有礼貌地告知”我在看”。

相关配置文章：

编辑：Cypher
更新时间：2026-02-28