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 Kura-chan app says “connect failed” / invalid_auth

Section titled “The Kura-chan app 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.