Skip to content
Kura-chan Docs
Home

Verify & troubleshooting

Verify the connection

Section titled “Verify the connection”

  1. DM the bot

    Open a direct message with Kura-chan and send “hello”. You should get a reply within a few seconds.

  2. @mention it in a channel

    Invite the bot with /invite @Kura-chan, then post @Kura-chan are you there?. It replies in the thread.

  3. Run a slash command

    Type /kura-help and send. The help card confirms slash commands are wired up.

If all three work, you’re done. If not, find the symptom below.

Troubleshooting

Section titled “Troubleshooting”

The dashboard says “connect failed” / invalid_auth

Section titled “The dashboard says “connect failed” / invalid_auth”

Cause: a token is wrong, swapped, or truncated.

Fix:

  • Make sure the xoxb-… value is in the Bot field and the xapp-… value is in the App-level field — not swapped.
  • Re-copy both, watching for trailing spaces.
  • If you changed scopes after installing, reinstall the app and copy the new xoxb-….

Bot never replies to DMs

Section titled “Bot never replies to DMs”

Cause: the message.im event or im:history scope is missing, or the sender isn’t allowed.

Fix:

  • Confirm the app was created from the manifest (or that message.im is under Subscribe to bot events and im:history is in scopes).
  • Check the allow_from allowlist — see below.

@mention in a channel does nothing

Section titled “@mention in a channel does nothing”

Cause: the bot isn’t in the channel, or app_mention / app_mentions:read is missing.

Fix:

  • Invite it: /invite @Kura-chan.
  • Confirm app_mention is subscribed and app_mentions:read is granted, then reinstall if you changed anything.

”Unknown command” or a slash command does nothing

Section titled “”Unknown command” or a slash command does nothing”

Cause: that command wasn’t registered on the app.

Fix:

  • Open Slash Commands in the app settings and confirm all eight /kura-* commands are listed. Re-creating the app from the manifest is the quickest fix.

”You are not authorized to use this command”

Section titled “”You are not authorized to use this command””

Cause: your Slack user isn’t in Kura-chan’s allow_from allowlist for the Slack channel.

Fix:

  • Add your Slack user (or leave allow_from empty to allow everyone) in the Slack channel config, then restart Kura-chan.

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

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

Cause: posting to a private or unjoined channel without membership.

Fix:

  • /invite @Kura-chan into the channel. The app doesn’t request chat:write.public, so every channel — public or private — needs the invite.

Still stuck?

Section titled “Still stuck?”
  • Re-create the app from the manifest — it rules out a missing scope, event, or command in one shot.
  • Check the launcher logs, usually under ~/.picoclaw/logs/, for lines tagged slack.