飞书如何为群聊设置单独的会话 ID，实现上下文分离

💡 问题场景：在群聊中，多个用户和机器人对话，上下文会混在一起。

🤔 为什么要设置独立会话？

默认情况（不设置）

群聊：oc_fd8fcdc8db7bc81ef7c8d8be56dda25b
会话 ID: agent:main:feishu:group:oc_fd8fcdc8db7bc81ef7c8d8be56dda25b

用户 A: "帮我写篇文章"
机器人：✅ 已创建...

用户 B: "修改一下标题"  ← 机器人会认为是在说用户 A 的文章！

问题：所有群成员共享同一个会话，上下文会混淆。

设置后（group_sender）

群聊：oc_fd8fcdc8db7bc81ef7c8d8be56dda25b

用户 A 的会话：agent:main:feishu:group:oc_xxx:sender:ou_aaa
用户 B 的会话：agent:main:feishu:group:oc_xxx:sender:ou_bbb

用户 A: "帮我写篇文章"
机器人：✅ 已创建...（在 A 的会话中）

用户 B: "修改一下标题"  ← 机器人知道 B 没有文章，会询问上下文

优势：每个群成员有独立的对话历史，互不干扰。

🏗️ 会话 ID 结构解析

默认格式（群共享）

agent:{agentId}:feishu:group:{chatId}

示例：

agent:main:feishu:group:oc_fd8fcdc8db7bc81ef7c8d8be56dda25b

设置 group_sender 后（每人独立）

agent:{agentId}:feishu:group:{chatId}:sender:{userId}

示例：

agent:main:feishu:group:oc_fd8fcdc8db7bc81ef7c8d8be56dda25b:sender:ou_0baccfaa8d668f89472b50281419e8d9

⚙️ 配置步骤

1. 找到配置文件

~/.openclaw/openclaw.json

2. 编辑飞书渠道配置

找到 channels.feishu 部分：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "connectionMode": "websocket",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxxx",
          "appSecret": "xxxxxxxxxxxxxxxxxxxxx",
          "botName": "AI Assistant"
        }
      }
    }
  }
}

3. 添加 groupSessionScope

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "groupSessionScope": "group_sender",  ← 新增这行
      "connectionMode": "websocket",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxxx",
          "appSecret": "xxxxxxxxxxxxxxxxxxxxx",
          "botName": "AI Assistant"
        }
      }
    }
  }
}

4. 重启 OpenClaw Gateway

openclaw gateway restart

📊 配置选项说明

🔍 验证配置

方法 1：查看会话状态

openclaw sessions list

设置前：

agent:main:feishu:group:oc_xxx

设置后：

agent:main:feishu:group:oc_xxx:sender:ou_aaa
agent:main:feishu:group:oc_xxx:sender:ou_bbb

方法 2：查看会话文件

ls -la ~/.openclaw/agents/main/sessions/

设置后会有多个会话文件，每个对应一个群成员。

方法 3：实际测试

在群聊中：

1. 用户 A 说："帮我写篇文章"
2. 用户 B 说："我有几篇文章？"

如果机器人正确回答用户 B 没有文章，说明配置成功！

💡 使用场景

适合设置 group_sender 的情况

✅ 多人协作的群聊
✅ 每个人都和机器人有独立对话
✅ 需要隐私隔离（不想让别人看到你的对话历史）

适合保持群共享会话的情况

✅ 机器人主要服务整个群（如群公告、群统计）
✅ 对话内容本身是公开的
✅ 需要机器人记住群级别的上下文

🎯 实际案例

案例 1：技术讨论群

场景：50 人的技术交流群，大家经常问机器人问题。

配置：groupSessionScope: "group_sender"

效果：

• 每个人有自己的对话历史
• A 问的部署问题不会影响 B 的对话
• 隐私得到保护

案例 2：项目管理群

场景：10 人的项目群，机器人用于记录群决策。

配置：不设置（群共享）

效果：

• 所有人都能看到机器人的回复
• 机器人记住的是群级别的上下文
• 适合协作场景

⚠️ 注意事项

1. 会话文件会增加 - 每个群成员一个会话文件
2. 历史会话不受影响 - 设置前的共享会话保持不变
3. 需要重启 Gateway - 配置修改后必须重启才能生效

📝 完整配置示例

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "groupSessionScope": "group_sender",
      "connectionMode": "websocket",
      "accounts": {
        "main": {
          "appId": "cli_a92461419db8dcc0",
          "appSecret": "GJOg5vG7cQuCUcPgjDSKHbUynbu4jXTN",
          "botName": "AI Assistant"
        }
      }
    },
    "dingtalk": {
      "enabled": true,
      "corpId": "ding7513b57291b216bea1320dcb25e91351",
      "clientId": "dingw0obhnq2idvevhfp",
      "clientSecret": "fI7cfcfZ3fcjmpqKQHE5XyMtvqUCWzQ1rtB-gawWLxVIQuHI36HtQWISsry8YGPv",
      "robotCode": "dingw0obhnq2idvevhfp",
      "agentId": 4320996166,
      "dmPolicy": "open",
      "groupPolicy": "open",
      "messageType": "markdown"
    }
  }
}

🎁 总结

配置 groupSessionScope: "group_sender" 的好处：

✅ 每个群成员有独立的对话上下文
✅ 避免对话混淆
✅ 保护用户隐私
✅ 更适合多人协作场景

配置步骤回顾：

1. 编辑 ~/.openclaw/openclaw.json
2. 在 channels.feishu 中添加 groupSessionScope: "group_sender"
3. 重启 openclaw gateway restart

让每个用户都有自己的"专属"机器人体验！ ✨