Registry / communication / openclaw-xiaoyou

openclaw-xiaoyou

JSON →
library1.4.11jsnpmunverified

Xiaoyou channel plugin for OpenClaw (v1.4.11, active development) — connects enterprise internal services to OpenClaw Gateway via persistent outbound WebSocket. No public port needed on the enterprise side. Configuration is written into the OpenClaw config file (~/.openclaw/config.json), not a separate plugin file. Provides CLI commands for connection status and test messaging. Supports DM security modes (open/allowlist), heartbeat with custom intervals, and exponential backoff reconnection. Released under MIT.

communication
npm install openclaw-xiaoyou
package ↗
INSTALL
IMPORT
SIG · OPENCLAW-XIAOYOU
O
openclaw-xiaoyou
communicationjavascriptv1.4.11
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

openclaw-xiaoyou (plugin)
✓ openclaw plugins install openclaw-xiaoyou
✗ npm install openclaw-xiaoyou # wrong: not a direct dependency, use openclaw CLI to install as plugin
This is an OpenClaw plugin, not a standard npm package. Install and enable via openclaw CLI.

Shows installation, configuration via CLI wizard, and basic usage commands.

openclaw plugins install openclaw-xiaoyou openclaw plugins enable openclaw-xiaoyou # Configure via interactive wizard openclaw channels add --channel xiaoyou # Or manually edit ~/.openclaw/config.json # Add under 'channels': # { # "xiaoyou": { # "enabled": true, # "wsUrl": "wss://im.corp.example.com/ws", # "authToken": "your-enterprise-auth-token", # "dmSecurity": "open", # "allowFrom": [], # "reconnectIntervalMs": 3000, # "maxReconnectAttempts": 0, # "heartbeatIntervalMs": 30000, # "heartbeatTimeoutMs": 10000 # } # } # Check connection status openclaw xiaoyou status # Send a test message openclaw xiaoyou test --to "conv123" --text "Hello"
Debug
Known issues
gotchaConfiguration must be placed in OpenClaw's config file (~/.openclaw/config.json), not in the plugin directory.
fix
Edit ~/.openclaw/config.json under the 'channels' key. Plugin-specific config.example.json is a template, not loaded automatically.
affects: >=1.0
gotchaPlugin is installed via openclaw CLI, not npm install. Using npm install will install the package but won't register it as a plugin.
fix
Use 'openclaw plugins install openclaw-xiaoyou' (without npm).
affects: >=1.0
gotchaThe wsUrl must point to a WebSocket server (ws:// or wss://) that accepts persistent outbound connections. HTTP URLs will fail.
fix
Ensure wsUrl starts with ws:// or wss://. For local testing use 'ws://127.0.0.1:9090'.
affects: >=1.0
gotchaIf dmSecurity is set to 'allowlist', allowFrom must contain at least one user ID, otherwise all messages are blocked.
fix
Add user IDs to allowFrom array when using allowlist mode.
affects: >=1.0
Errors
Common errors & fixes
Error: openclaw-xiaoyou plugin not found
Plugin not installed or enabled.
fix
Run: openclaw plugins install openclaw-xiaoyou && openclaw plugins enable openclaw-xiaoyou
Error: connection closed with code 1006
WebSocket handshake failed, auth token invalid or wsUrl incorrect.
fix
Verify wsUrl and authToken in ~/.openclaw/config.json, and ensure enterprise server is reachable.
Upgrade
Version history
1.4.11latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
13 hits · last 30 days
node
12
OpenAI (training)
1
Resources
packageopenclaw-xiaoyou ↗
openclaw-xiaoyou — npm install openclaw-xiaoyou · libregistry