Phase 5 / Ep 27: Plugin Release and Lifecycle Management

⏱ Est. reading time: 3 min Updated on 4/13/2026

🎯 Learning Objective: Publish a Plugin and manage its complete lifecycle.

1. Publish to ClawHub

cd ~/.openclaw/plugins/notion-sync
npx clawhub publish --type plugin

2. Update Strategy

Hot Update (Recommended)

No Gateway restart required, Plugin automatically detects and loads the new version:

openclaw plugins update notion-sync

Cold Restart

Gateway restart required:

openclaw plugins install [email protected]
openclaw gateway restart

3. Lifecycle

stateDiagram-v2
    [*] --> Developing: Development
    Developing --> Testing: Local Testing
    Testing --> Published: Published to ClawHub
    Published --> Active: User Installed
    Active --> Updated: New Version Released
    Updated --> Active: User Updates
    Active --> Deprecated: Marked Deprecated
    Deprecated --> Archived: Archived after 6 months
    Archived --> [*]

4. Version Management

Version Type Format Impact
Patch 1.0.x Bug fixes, automatic updates
Minor 1.x.0 New features, update notification
Major x.0.0 Breaking changes, manual updates

5. Deprecation and Migration

# Mark Plugin as deprecated
npx clawhub deprecate notion-sync --message "Please migrate to notion-sync-v2"

# Provide migration guide
npx clawhub deprecate notion-sync --alternative notion-sync-v2

Next Episode Preview: Phase 6 begins! Ep 28, Deep Telegram Integration — The complete journey from BotFather to a production-grade bot.