验证与故障排查

验证连接

1. 给机器人发私信

   打开与 Kura酱 的私信，发送“你好”。几秒内应当收到回复。

2. 在频道中 @提及它

   用 /invite @Kura酱 邀请机器人，然后发 @Kura酱 你在吗？。它会在话题串中回复。

3. 运行一个斜杠命令

   输入 /kura-help 并发送。出现帮助卡片，就说明斜杠命令已接通。

三项都通过，就配置好了。若有问题，按下面的症状排查。

故障排查

仪表盘提示“连接失败” / invalid_auth

原因：某个令牌填错、填反，或被截断。

解决：

• 确认 xoxb-… 在 Bot 输入框、xapp-… 在 App 级输入框 —— 别填反。
• 两个都重新复制，注意末尾空格。
• 若安装后改过作用域，重新安装应用并复制新的 xoxb-…。

---

机器人不回复私信

原因：缺少 message.im 事件或 im:history 作用域，或发送者未被允许。

解决：

• 确认应用是从清单创建的（或 message.im 在 Subscribe to bot events 中、im:history 在作用域中）。
• 检查 allow_from 允许列表（见下）。

---

频道中的 @提及没有反应

原因：机器人不在该频道，或缺少 app_mention / app_mentions:read。

解决：

• 邀请它：/invite @Kura酱。
• 确认 app_mention 已订阅、app_mentions:read 已授予；若改过设置则重新安装。

---

“Unknown command” 或斜杠命令无反应

原因：该命令未在应用中注册。

解决：

• 打开应用设置的 Slash Commands，确认 8 个 /kura-* 命令都在列表中。从清单重建应用是最快的修法。

---

“You are not authorized to use this command”

原因：你的 Slack 用户不在 Kura酱 针对 Slack 渠道的 allow_from 允许列表中。

解决：

• 在 Slack 渠道配置中添加你的 Slack 用户（或把 allow_from 留空以允许所有人），然后重启 Kura酱。

---

“can’t post to #channel — invite the bot…”

原因：向未加入或私密的频道发消息。

解决：

• 用 /invite @Kura酱 把它邀请进频道。应用不请求 chat:write.public，因此无论公开还是私密频道都需要邀请。

---

仍然不行？

• 从清单重建应用，可一次性排除作用域、事件或命令的遗漏。
• 查看启动器日志（通常在 ~/.picoclaw/logs/）中带 slack 标签的行。