buma logo
山东临沂 · 远程可协作 预约咨询
OpenClaw FAQ

OpenClaw 常见问题 FAQ：先按你卡住的那一步找入口。

这页不再堆旧链接，而是把现在最常见的 OpenClaw 问题重新归类：飞书怎么接、权限为什么不生效、群里为什么要 @ 才回、Dashboard 为什么打不开、Gateway 为什么起不来、日志应该先看哪条、Chrome 扩展为什么挂着感叹号、定时任务怎么跑。你可以先快速定位问题，再进入对应正文继续看。

先按问题直达
先按问题入口分流，再决定自己排还是直接沟通 若 10 分钟还没收口，再发页面 / 截图 / 最卡的 1 步 工作日 24h 内先回复你下一步该先动哪里
接入 / 权限 / 控制台 / 日志 高频问题覆盖 · 先分入口 再进正文 · 工作日 24h 内响应 · 截图 / 链接 / 卡点 发来即可开始判断

如果你还没准备好自己排，继续看 文章中心 / 直接沟通当前问题。FAQ 第一屏只主推 1 个动作：先把问题分到对的入口，再决定自己排还是直接找人。

优先覆盖接入 / 权限 / 控制台 / 日志 先分入口，再进正文 减少“翻半天还没找到那一篇”

最近更新

2026-03-14

适合谁看

正在排 OpenClaw 飞书接入、Dashboard、Gateway、日志、Chrome 扩展或定时任务问题的人。

这页覆盖什么

飞书接入、权限配置、群聊 @ 触发、pairing、Dashboard、Gateway、logs、Chrome 扩展和 cron 定时任务入口。

资料来源

OpenClaw Getting Started、Feishu、Pairing、Dashboard、Gateway Troubleshooting 官方文档，以及 Clawdbot 中文公开文档。

First 10 Minutes

先做 3 个快速检查，排查会快很多

参考 Stripe / OpenAI Help Center 的“先分入口、再细化问题”写法，把最容易漏掉的三步前置，先判断是不是入口问题。

1. 先确认 Gateway 是否在线 Dashboard 打不开、unauthorized 多数与 gateway / 鉴权有关。
2. 先确认群聊触发边界 requireMention / groupPolicy 配置不对，会表现为“群里不回”。
3. 先确认配对与事件订阅 pairing 未审批或事件未订阅，消息就收不到。
做完检查，按问题直达
Quick Paths

按问题直达

如果你现在已经卡住了，就别从头翻了，直接进对应问题页。先把入口找对，排查速度会快很多。

Still Stuck?

如果你按 FAQ 查了 10 分钟还没收口，先别继续乱翻，先发这 3 样，再开始 15 分钟适配判断

这一步借了 Stripe 联系页“只要少量信息 + 明确回应时效”的结构：FAQ 不该让用户无限下滑，而要在合适位置明确告诉他，什么时候该停止自查、改为带材料进入沟通。想先看这条升级边界为什么重要，可直接读这篇 FAQ→Contact 结构文；如果你更想先对照“联系页第一次到底该发什么”，也可以继续看 联系页首条消息清单 SEO。

页面或相关链接 先给当前页面、后台地址或你正在看的入口，让问题发生在哪一层一眼可定位。
1 张截图或 1 段日志 优先带报错截图、日志关键行、配置片段或 Gateway 状态输出，不要只说“就是不行”。
你现在最卡的 1 步 别一次抛 10 个问题，先说清这次最想先解决的是收发、Dashboard、权限，还是接入承接。
先发这 3 样，开始 15 分钟适配判断

工作日 24 小时内会先告诉你下一步该先动哪里；现在只要先发：页面或链接 / 相关截图 / 最卡的 1 步。若你还在判断“要不要继续自己排”，先看 FAQ 升级沟通 SEO 结构文，再决定继续排查还是直接联系。

Dashboard / Gateway

控制台、服务状态和日志排障入口

如果你卡的不是“飞书接不进来”，而是 Dashboard 打不开、Gateway 启不来、日志看不懂、页面反复报 unauthorized，优先从这组入口开始。它们属于同一类问题，但排查顺序并不一样。

OpenClaw logs 怎么看

适合先学会看 openclaw logs --follow、状态面板和常见日志信号，把“到底是哪一层坏了”快速拆出来。

Gateway 起不来怎么办

适合排查 gateway.mode=local、严格配置校验、非 loopback 鉴权限制、EADDRINUSE 和端口占用。

Top Questions

最常见的 4 类 FAQ

最近高频问题基本都集中在这 4 类。先看自己属于哪一类，再继续深挖。

1. 接入类：到底应该先做什么

  • 先确认 Node、Gateway 和 Dashboard 正常。
  • 再创建飞书应用、填 App ID / Secret。
  • 然后核对事件订阅、Bot 权限和 pairing。
  • 最后再去看群聊规则、定时任务和协作链路。

先看：OpenClaw 飞书机器人接入清单

2. 权限类：看起来都开了，为什么还是发不出去

  • 常见不是“没开权限”，而是开错位置或版本没发布。
  • 飞书事件订阅、Bot 能力和消息发送权限要一起看。
  • 群聊里能不能回，还会受 groupPolicy 和 allowFrom 影响。
  • 排查时别只盯一个报错，要把权限、发布状态和触发链路一起看。

先看：OpenClaw 飞书机器人权限清单

3. 群聊类：为什么私聊能回，群里却经常没反应

  • 默认安全策略通常比想象中更严格。
  • 很多场景下群聊就是要求明确 @，避免误触发。
  • pairing 没通过、群未放行、触发人不在白名单，也会像“没回复”。
  • 这类问题要同时看 requireMention、groupPolicy 和 allowFrom。

先看：OpenClaw 飞书群里为什么不回复

4. 控制台与自动化类：页面打不开、定时任务不触发

  • Dashboard 问题先拆成服务状态、鉴权、配对三层。
  • Gateway 问题再继续拆成配置模式、端口占用、认证前提三层。
  • 日志问题先看 openclaw logs --follow，再回到对应模块处理。
  • 别把所有报错混成一个问题看，分层后更容易处理。

先看：OpenClaw Dashboard 打不开怎么办

继续：OpenClaw gateway 起不来怎么办

Related Reading

继续往下看什么

如果你不是只想排 1 个点，而是想把 OpenClaw 的接入、协同和使用链路整体看清，可以沿着这条顺序看。

Next Step

排完当前问题后，下一步通常去哪

这页负责帮你先定位问题；如果你已经知道自己下一步要补“方案、文章还是沟通”，可以直接走最短路径，不必继续在 FAQ 里打转。

想先看整体路径

如果你还没判断清楚自己是起步、承接还是转化问题，先去解决方案页，看不同阶段应该先补什么。

去解决方案页

想继续系统阅读

如果你不是只排一个故障，而是想把 OpenClaw、飞书接入和一人公司内容承接整体理顺，直接进入文章中心更快。

去文章中心

已经有明确卡点

如果你已经知道自己卡在哪一步，且希望更快判断该怎么处理，可以直接带着当前问题去联系页继续沟通。

去联系页

What You Leave With

在 FAQ 里逛完，你会带走这 3 样东西

这页不是让你继续留在 FAQ 里打转，而是帮你判断：现在该继续看文章、去联系，还是先回到首页走最短路径。

①
你卡的这步属于接入、权限还是触发 FAQ 的目的不是给你所有答案，而是帮你先分清楚问题在哪一层，避免在错误的地方花时间。
②
当前最值得先读哪一篇 如果你看完 FAQ 还没解决，会明确告诉你先去读哪篇，而不是继续在 FAQ 里来回翻。
③
是否值得现在就带着问题来聊 如果你已经确认是接入或配置类问题，会直接告诉你去联系页，而不是继续在 FAQ 里找答案。
带着明确问题来聊一次 还没准备好？可先 看文章中心 / 去解决方案页