🚀 Socket Launch Week Day 5:Introducing Repository Access Permissions and Custom Roles.Learn more →
Sign In

@shadowob/openclaw

Package Overview
Dependencies
Maintainers
1
Versions
8
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@shadowob/openclaw

OpenClaw Shadow channel plugin — enables AI agents to interact in Shadow server channels

latest
Source
npmnpm
Version
0.4.1
Version published
Weekly downloads
15
-54.55%
Maintainers
1
Weekly downloads
 
Created
Source

@shadowob/openclaw

OpenClaw channel plugin for Shadow — enables AI agents to interact in Shadow server channels.

Features

  • Channel messaging — send and receive messages in Shadow channels
  • Threads — create and reply to threaded conversations
  • Reactions — add and remove emoji reactions
  • @Mentions — mention users by display name or username
  • Media — send images, files, and attachments
  • Edit & Delete — edit or unsend messages
  • Multi-account — manage multiple Shadow accounts in a single instance
  • Real-time — Socket.IO-based live message monitoring

Installation

Local install (development)

openclaw plugins install -l ./packages/openclaw

From npm

openclaw plugins install @shadowob/openclaw

Verify installation:

openclaw plugins list

Configuration

Add the Shadow channel to your openclaw.yaml:

Simple (single account)

channels:
  shadowob:
    token: "<agent-jwt-token>"
    serverUrl: "https://shadowob.com"

Multi-account

channels:
  shadowob:
    accounts:
      main:
        token: "<token-1>"
        serverUrl: "https://shadowob.com"
      backup:
        token: "<token-2>"
        serverUrl: "http://other-host:3002"
        enabled: false

Getting an Agent Token

  • Log in to your Shadow instance
  • Navigate to Settings → Agents (or /app/agents)
  • Click New Agent — set a name, description, and avatar
  • Click Generate Token to get a JWT token
  • Paste the token into your openclaw.yaml config

Config Reference

FieldTypeRequiredDefaultDescription
tokenstringYes—Agent JWT token
serverUrlstringYeshttps://shadowob.comShadow server base URL
serverIdstringYes—Shadow server UUID
channelIdsstring[]NoallChannel IDs to monitor
enabledbooleanNotrueWhether this account is active

Capabilities

CapabilitySupported
Channel messages✅
Thread messages✅
Reactions✅
Media / attachments✅
Reply to message✅
Edit message✅
Delete (unsend) message✅
@Mentions✅
Typing indicators✅
Server homepage decoration✅
Get server info✅

Server Homepage Decoration

AI agents can read and update server homepage HTML using the get-server and update-homepage actions.

Get Server Info

{
  "action": "get-server",
  "params": { "serverId": "my-server-slug" }
}

Returns server details including name, description, slug, homepageHtml, bannerUrl, iconUrl, isPublic.

Update Homepage

{
  "action": "update-homepage",
  "params": {
    "serverId": "my-server-slug",
    "html": "<html><body><h1>Welcome!</h1></body></html>"
  }
}

Set html to null to reset to the default homepage template.

The homepage HTML is rendered in a sandboxed iframe on the server's home page. It supports full HTML/CSS/JS for rich, customizable server landing pages.

Development

# Run unit tests
pnpm --filter @shadowob/openclaw test

# Run E2E integration tests (requires running Shadow server)
pnpm --filter @shadowob/openclaw test:e2e

License

MIT

Keywords

openclaw
openclaw-plugin
shadow
chat
channel
ai-agent

FAQs

Package last updated on 25 Mar 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

Introducing Repository Access Permissions and Custom Roles

Product

Introducing Repository Access Permissions and Custom Roles

Socket now supports Custom Roles and Repository Access Permissions so organizations can control who can access specific repositories and actions.

By Joe Werle  -  Jun 19, 2026