如何解决接入飞书后群里其他人@后无反应的问题

💡 本文适合人群：已经成功部署 OpenClaw 并接入飞书，但遇到群成员@机器人无响应或工具无法调用问题的开发者。

📋 常见问题

在将 OpenClaw 接入飞书后，很多开发者会遇到以下两个常见问题：

1. 群里其他人@机器人无响应 - 只有管理员@才有反应
2. 组件（工具）无法调用 - web_search、web_fetch 等工具报错或无反应

本文将详细分析这两个问题的根本原因，并提供完整的解决方案。

🔍 问题一：群里其他人@机器人无响应

问题现象

• ✅ 你自己（创建者/管理员）在群聊中@机器人时，机器人会正常回复
• ❌ 其他同事在群聊中@机器人时，机器人完全没反应，就像没收到消息一样

根本原因

这个问题的根本原因是 飞书通道的群聊策略 groupPolicy 被设置为 allowlist（白名单模式），且白名单 groupAllowFrom 中只包含了你自己的用户 ID。

因此，其他群成员的@请求被 OpenClaw 过滤掉了，机器人根本收不到这些消息。

解决方案

方法一：临时改为开放模式（推荐用于测试）

执行以下命令将群聊策略临时改为开放模式，允许所有群成员触发机器人：

openclaw config set channels.feishu.groupPolicy open

执行后重启网关：

openclaw gateway restart

效果：所有群成员@机器人都能得到响应。

方法二：配置白名单模式（推荐用于生产）

如果出于安全考虑希望恢复白名单模式，可以按以下步骤操作：

1. 获取同事的飞书用户 ID

让同事在飞书中发送任意消息，然后在日志中查看用户 ID，格式为 ou_xxxxxxxxxxxxx。

或者通过飞书开放平台的用户管理接口获取。

2. 将用户 ID 添加到白名单

编辑配置文件 ~/.openclaw/openclaw.json，在 channels.feishu 部分添加 groupAllowFrom 配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxx",
      "appSecret": "xxxxxxxxxxxxxxxxxxxxx",
      "groupPolicy": "allowlist",
      "groupAllowFrom": [
        "ou_4826a96739cd23da2ec45e93f04b25b9",
        "ou_0baccfaa8d668f89472b50281419e8d9",
        "ou_71cd8a4317bf0ea23a6b53ed5caba7a0"
      ]
    }
  }
}

3. 重启网关使配置生效

openclaw gateway restart

配置说明

最佳实践建议

1. 开发测试环境：使用 open 模式，方便测试
2. 生产环境：使用 allowlist 模式，只允许授权用户触发
3. 定期审查：定期检查白名单列表，移除不再需要的人员

🔧 问题二：组件（工具）无法调用

问题现象

• ❌ 机器人无法使用内置工具（如联网搜索 web_search、获取网页内容 web_fetch 等）
• ❌ 执行相关指令时报错或没有任何反应
• ❌ 日志中显示工具调用被拒绝或权限不足

根本原因

你升级到的 OpenClaw 版本（3.2+）出于安全考虑，默认将新创建 agent 的工具权限设置为关闭或受限状态。

这是为了防止 AI 误用工具造成意外后果，但同时也导致正常功能无法使用。

解决方案

方法一：编辑配置文件（推荐）

1. 打开配置文件

编辑 ~/.openclaw/openclaw.json 文件：

nano ~/.openclaw/openclaw.json

2. 添加工具权限配置

在配置文件中找到或添加 tools 字段，配置如下：

{
  "tools": {
    "profile": "full",
    "sessions": {
      "visibility": "all"
    }
  }
}

完整配置示例：

{
  "gateway": {
    "port": 8080,
    "host": "0.0.0.0"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxx",
      "appSecret": "xxxxxxxxxxxxxxxxxxxxx",
      "groupPolicy": "open"
    }
  },
  "models": {
    "default": "bailian/qwen3.5-plus",
    "bailian": {
      "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxx"
    }
  },
  "tools": {
    "profile": "full",
    "sessions": {
      "visibility": "all"
    }
  }
}

3. 重启网关使配置生效

# 使用 openclaw 命令
openclaw gateway restart

# 或使用 systemctl（系统服务方式）
sudo systemctl restart openclaw-gateway.service

方法二：使用命令行配置（部分版本支持）

# 设置工具权限为完整模式
openclaw config set tools.profile full

# 设置会话可见性为全部
openclaw config set tools.sessions.visibility all

# 重启网关
openclaw gateway restart

配置说明

可用工具列表

配置完成后，机器人可以使用以下工具：

• 💬 消息工具：message - 发送消息、回复消息
• 📄 文档工具：feishu_create_doc、feishu_fetch_doc、feishu_update_doc
• 📊 表格工具：feishu_bitable_app、feishu_sheet
• 📅 日历工具：feishu_calendar_event、feishu_calendar_freebusy
• ✅ 任务工具：feishu_task_task、feishu_task_tasklist
• 🌐 网络工具：web_search、web_fetch
• 🔍 搜索工具：memory_search、feishu_search_user
• 🗂️ 文件工具：read、write、edit、exec

🔍 验证配置是否生效

验证群聊权限

1. 让同事在群聊中@机器人，发送消息：

   @机器人 你好
   

2. 如果机器人回复，说明群聊权限配置成功。

验证工具权限

1. 发送测试命令：

   帮我搜索一下 OpenClaw 的最新版本
   

2. 如果机器人能够调用 web_search 工具并返回搜索结果，说明工具权限配置成功。
3. 或者发送：

   帮我读取一下 /root/.openclaw/openclaw.json 文件
   

4. 如果机器人能够读取文件内容，说明文件工具权限正常。

🛠️ 故障排查

问题 1：配置修改后仍然无效

解决方法：

1. 检查配置文件语法是否正确：

   cat ~/.openclaw/openclaw.json | python -m json.tool
   

2. 查看网关日志：

   openclaw gateway logs
   # 或
   pm2 logs blog
   

3. 确认网关已重启成功：

   openclaw gateway status
   

问题 2：日志显示权限错误

可能原因：

• 飞书机器人权限不足
• 配置文件权限问题

解决方法：

1. 检查飞书开发者后台的权限配置
2. 确保配置文件所有者正确：

   chown -R $USER:$USER ~/.openclaw
   

问题 3：部分工具可用，部分不可用

可能原因：

• 工具权限配置不完整
• 某些工具需要额外授权

解决方法：

1. 确认 tools.profile 设置为 full
2. 检查特定工具是否需要额外配置（如飞书工具需要 OAuth 授权）

📚 相关资源

• OpenClaw 官方文档
• OpenClaw GitHub
• 飞书官方插件使用指南
• OpenClaw 配置说明

🎯 总结

通过以上配置，你可以解决两个常见问题：

✅ 群成员@无响应 - 修改 groupPolicy 为 open 或配置白名单
✅ 工具无法调用 - 配置 tools.profile 为 full

配置完成后记得重启网关，让配置生效！

如果遇到其他问题，欢迎查看日志文件或联系 OpenClaw 社区获取帮助。

祝你使用愉快！ 🎉