飞书机器人互@失败？检查这3个权限

OpenClaw机器人在飞书群聊中无法互相@的问题，核心在于权限配置和事件订阅两个关键环节。通过系统性地检查飞书应用权限、配置正确的事件订阅机制、并验证WebSocket连接稳定性，可以彻底解决这一问题。建议按照本文提供的步骤逐一排查，重点关注权限和事件订阅的配置情况。完成所有配置后，记得重新发布应用并测试@功能是否正常响应。

Dxy122

305人浏览 · 2026-03-12 12:32:59

Dxy122 · 2026-03-12 12:32:59 发布

OpenClaw机器人无法在飞书群聊中互相@的解决方案

问题分析

根据您描述的情况，在安装OpenClaw后，飞书群聊中的机器人无法互相@，这通常是由于以下几个关键配置问题导致的：

问题类别	具体原因	影响程度
权限配置	缺少必要的消息收发权限	高
事件订阅	未正确配置消息接收事件	高
机器人能力	机器人功能未完全启用	中
配对机制	设备或应用配对异常	中

核心解决方案

1. 检查飞书应用权限配置

首先需要确认您的飞书自建应用是否具备正确的权限。根据参考资料，必须开通以下核心权限：

# 必需权限列表
required_permissions:
  - im:message  # 收发单聊、群组消息
  - im:message.group_at_msg  # 接收群聊中@机器人的消息
  - im:message.p2p_msg  # 接收单聊消息
  - contact:user.id  # 获取用户ID信息
  - contact:user.base  # 获取用户基本信息

配置步骤：

登录飞书开放平台 → 进入您的自建应用
选择"权限管理" → 搜索并添加上述权限
提交审核并等待权限生效

2. 验证机器人能力设置

确保机器人功能已正确启用：

// 机器人能力配置检查清单
const botCapabilities = {
  messageReceiving: true,      // 接收消息能力
  atMessageHandling: true,     // 处理@消息能力  
  groupMessage: true,          // 群组消息能力
  webhookOrWebsocket: true     // 事件订阅方式
};

在飞书开放平台的"功能" → "机器人"中确认：

✅ 已开启机器人能力
✅ 配置了正确的消息订阅模式

3. 配置事件订阅机制

OpenClaw支持两种事件订阅方式，推荐使用WebSocket长连接模式：

WebSocket配置示例：

# OpenClaw配置文件 feishu.yaml
feishu:
  app_id: "您的App ID"
  app_secret: "您的App Secret"
  event_subscription:
    type: "websocket"  # 使用WebSocket长连接
    events:
      - "im.message.receive_v1"  # 消息接收事件
  permissions:
    - "im:message"
    - "im:message.group_at_msg"

关键配置要点：

事件类型必须包含 im.message.receive_v1
确保WebSocket服务正常运行
验证事件回调URL可访问性

4. 完整的权限申请流程

以下是详细的权限申请步骤表格：

步骤	操作	预期结果
1	飞书开放平台 → 应用详情	进入应用管理界面
2	权限管理 → 搜索权限	找到所需权限项
3	添加权限 → 提交审核	生成权限申请记录
4	等待审核通过	权限状态变为"已获得"
5	发布新版本	使权限生效
6	重新安装应用到飞书	应用获得新权限

5. 调试与验证方法

配置完成后，需要进行系统验证：

# 检查OpenClaw服务状态
sudo systemctl status openclaw

# 查看服务日志
journalctl -u openclaw -f

# 测试飞书连接
openclaw channel test feishu

验证步骤：

在飞书群聊中@OpenClaw机器人
观察是否收到响应
检查OpenClaw日志中的消息接收记录
确认事件处理流程正常

6. 常见问题排查

如果上述配置完成后问题仍然存在，请检查以下方面：

问题现象	可能原因	解决方案
完全无响应	事件订阅未配置	重新配置WebSocket事件
能收到消息但无@响应	权限不足	检查group_at_msg权限
间歇性不响应	网络连接问题	检查WebSocket连接稳定性
仅单聊正常	群聊权限缺失	补充群组相关权限

技术实现细节

WebSocket事件处理核心代码

// OpenClaw飞书插件消息处理逻辑
class FeishuMessageHandler {
  async handleMessage(event) {
    const message = event.message;
    
    // 检查是否为@机器人的消息
    if (message.mentions && message.mentions.includes(this.botId)) {
      await this.processAtMessage(message);
    }
    
    // 检查是否为群聊消息
    if (message.chat_type === 'group') {
      await this.processGroupMessage(message);
    }
  }
  
  async processAtMessage(message) {
    // 处理@消息的业务逻辑
    const response = await this.aiService.generateResponse(message);
    await this.replyMessage(message.chat_id, response);
  }
}

权限验证脚本

#!/usr/bin/env python3
# 飞书权限验证工具

import requests

def check_feishu_permissions(app_id, app_secret):
    """
    验证飞书应用权限配置
    """
    # 获取访问令牌
    token_url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
    token_data = {
        "app_id": app_id,
        "app_secret": app_secret
    }
    
    response = requests.post(token_url, json=token_data)
    access_token = response.json()["tenant_access_token"]
    
    # 检查权限范围
    perm_url = "https://open.feishu.cn/open-apis/application/v6/scopes"
    headers = {"Authorization": f"Bearer {access_token}"}
    
    perm_response = requests.get(perm_url, headers=headers)
    permissions = perm_response.json()["data"]["scopes"]
    
    required_perms = ["im:message", "im:message.group_at_msg"]
    missing_perms = [perm for perm in required_perms if perm not in permissions]
    
    return len(missing_perms) == 0, missing_perms