Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ixo.world/llms.txt

Use this file to discover all available pages before exploring further.

Source: packages/oracle-runtime/src/plugins/slack/
AttributeValue
Visibilitysilent
Stabilitystable
Categorycore
Default stateAuto-detect (env: SLACK_BOT_OAUTH_TOKEN)
Depends on—

​
Summary

Connects a Slack bot to the oracle. The plugin contributes no agent-visible tools — it is purely a transport. The agent does not know Slack exists; it just sees inbound messages on the Slack client. Ships its own NestJS module so the bot client can use OnModuleInit / OnModuleDestroy for socket-mode lifecycle and inject the Tier-0 services it needs (messages, sessions, cache).

​
Environment variables

VarRequiredDescription
SLACK_BOT_OAUTH_TOKENyesSlack bot OAuth token. Triggers auto-detect.
SLACK_APP_TOKENnoApp-level token (required for socket mode in production).
SLACK_USE_SOCKET_MODEnoDefaults to 'true'.
SLACK_MAX_RECONNECT_ATTEMPTSnoCoerced number; defaults to 10.
SLACK_RECONNECT_DELAY_MSnoCoerced number; defaults to 1000.

​
What it contributes

  • Tools: none.
  • Sub-agents: none.
  • Middleware: none.
  • HTTP routes: none directly.
  • Nest module: SlackModule (registered via getNestModules) — owns the Slack socket-mode client lifecycle.
  • Shared state: none.

​
Opt out / Opt in

const app = await createOracleApp({
  config,
  features: { slack: false }, // never load
  // features: { slack: true }, // force load (will fail env validation if SLACK_BOT_OAUTH_TOKEN missing)
  // features: { slack: 'auto' }, // run autoDetect (default)
});

​
When to use it

  • You want the same oracle reachable from Slack as well as the web client.

Add HTTP endpoints

Nest-module contribution pattern.

Visibility tiers

Why silent plugins are invisible to the agent.