add-slack
Add Slack as a channel. Can replace WhatsApp entirely or run alongside it. Uses Socket Mode and does not require a public webhook endpoint.
- License 许可
- MIT
- 所属仓库
- mbaker95/nanodex
- 最近更新
- 2026-03-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- add-slack
- description
- Add Slack as a channel. Can replace WhatsApp entirely or run alongside it. Uses Socket Mode and does not require a public webhook endpoint.
03 SKILL.md 正文
Add Slack Channel
Use this skill when the user wants Slack as a primary or additional channel.
Slack is bundled in NanoDex core. The expected experience is:
- collect or create the Slack app tokens
- register the main Slack channel
- verify NanoDex can respond
Do the work yourself. Only stop when the user must create the Slack app, paste tokens, choose a channel, or perform a Slack-side action.
User Experience Rules
- Do not ask the user to understand remotes, branches, or code layout.
- Do not tell the user to invoke another skill manually.
- Prefer one clear question at a time in normal conversation. Do not use
AskUserQuestion. - If the user does not already have a Slack app, guide them through creating one plainly.
- On Windows or PowerShell hosts, prefer cross-platform commands or direct file edits over bash-only snippets.
Phase 1: Pre-flight
- Confirm the bundled Slack file exists:
src/channels/slack.ts. - Check whether
SLACK_BOT_TOKENandSLACK_APP_TOKENare already configured. - If tokens exist but registration is missing, skip to Phase 3.
Phase 2: Configure Slack Auth
Ask the user whether they already have a Slack app with:
- a Bot Token (
xoxb-...) - an App Token for Socket Mode (
xapp-...)
If not, guide them through creating one at api.slack.com/apps.
The essentials:
- create a Slack app
- enable Socket Mode and generate an App Token
- subscribe the bot to message events it needs
- add the required OAuth scopes
- install the app to the workspace
- paste both tokens back into the session
Once the tokens are available:
- write them to
.env - sync the runtime env if needed
Phase 3: Register the Main Channel
Ask where the user wants to talk to NanoDex:
- a main Slack channel
- a direct message channel with the bot
- an additional trigger-based channel
Then ask for or help discover the Slack channel ID.
Register the chosen channel with npx tsx setup/index.ts --step register ...
Use a sensible default folder name such as slack_main for the main channel.
Phase 4: Verify
After registration:
- run
npm run buildif code or env changed - restart the NanoDex service/runtime if needed
- tell the user the exact first message to send
Example verification guidance:
- main channel: “Send any message in the registered Slack channel”
- additional channel: “Send
@Assistant hello”
If verification fails, inspect logs and fix the issue before falling back to a troubleshooting list.
Troubleshooting Priorities
If Slack does not respond, check these in order:
- the Slack channel code is installed
- both Slack tokens are present where NanoDex reads env
- the Slack channel is registered
- the service/runtime is running
- Socket Mode is enabled and the bot has the right scopes
If Slack connects but sees no messages, check event subscriptions, scopes, and whether the bot was actually added to the target channel.
Completion
Finish by telling the user:
- which Slack channel was registered
- whether it is the main chat
- what trigger to use
- whether a restart was needed
- the exact first message to send for a live test
04 同仓库更多 Skills
agent-browser
Browse the web for any task — research topics, read articles, interact with web apps, fill forms, take screenshots, extract data, and test web pages. Use whenever a browser would be useful, not just when the user explicitly asks.
x-integration
X (Twitter) integration for NanoClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on "setup x", "x integration", "twitter", "post tweet", "tweet".
use-local-whisper
Use when the user wants local voice transcription instead of OpenAI Whisper API. Switches to whisper.cpp running on Apple Silicon. WhatsApp only for now. Requires voice-transcription skill to be applied first.
update-skills
Check for and apply updates to installed skill branches from upstream.
update-nanoclaw
Efficiently bring upstream NanoClaw updates into a customized install, with preview, selective cherry-pick, and low token usage.
setup
Run initial NanoClaw setup. Use when user wants to install dependencies, authenticate messaging channels, register their main channel, or start the background services. Triggers on "setup", "install", "configure nanoclaw", or first-time setup requests.