ContextQMD
Back to Eliza

Bluesky Plugin

packages/docs/plugin-registry/platform/bluesky.md

2.0.12.7 KB
Original Source

The Bluesky plugin connects Eliza agents to the Bluesky social network via the AT Protocol, enabling posting, replying, and social interactions.

Package: @elizaos/plugin-bluesky

Installation

This connector auto-enables when its configuration is present in eliza.json. You can also install it explicitly:

bash
eliza plugins install @elizaos/plugin-bluesky

Setup

1. Get Your Bluesky Credentials

  1. Go to bsky.app and create an account (or use an existing one)
  2. Note your handle (e.g., yourname.bsky.social)
  3. Use your account username and password (or generate an app password in Settings → App Passwords)

2. Configure Eliza

Set the credentials via environment variables in your config:

json
{
  "env": {
    "BLUESKY_HANDLE": "yourname.bsky.social",
    "BLUESKY_PASSWORD": "YOUR_APP_PASSWORD"
  },
  "connectors": {
    "bluesky": {
      "enabled": true
    }
  }
}

Set credentials via environment variables:

bash
export BLUESKY_HANDLE=yourname.bsky.social
export BLUESKY_PASSWORD=your-app-password

Configuration

FieldRequiredDescription
enabledNoSet false to disable (default: true)
postEnableNoEnable automated posting
postIntervalMinNoMinimum minutes between posts (default: 30)
postIntervalMaxNoMaximum minutes between posts (default: 60)
dryRunNoSimulate operations without executing them

Environment Variables

VariableRequiredDescription
BLUESKY_HANDLEYesBluesky handle (e.g., yourname.bsky.social)
BLUESKY_PASSWORDYesApp password (generate at Settings > App Passwords)
BLUESKY_ENABLEDNoSet to true to enable
BLUESKY_SERVICENoBluesky PDS instance URL
BLUESKY_DRY_RUNNoSet to true for testing without posting
BLUESKY_ENABLE_POSTINGNoEnable or disable post creation
BLUESKY_ENABLE_DMSNoEnable direct message processing
BLUESKY_POLL_INTERVALNoPolling interval in seconds
BLUESKY_ENABLE_POSTINGNoEnable automated posting
BLUESKY_ACTION_INTERVALNoInterval between actions in ms
BLUESKY_MAX_POST_LENGTHNoMaximum post length
BLUESKY_POST_IMMEDIATELYNoPost immediately on generation
BLUESKY_POST_INTERVAL_MAXNoMaximum minutes between posts
BLUESKY_POST_INTERVAL_MINNoMinimum minutes between posts
BLUESKY_MAX_ACTIONS_PROCESSINGNoMaximum concurrent actions
BLUESKY_ENABLE_ACTION_PROCESSINGNoEnable processing of actions