Instant mission state awareness without opening a single chat.
Real-time multi-agent orchestration in Telegram. No Web UI needed.
MISO is an OpenClaw skill that implements a 4+1 layer UX model for mission-critical work. It leverages Telegram's rich reaction system to give you immediate state visibility at a glanceβno need to open conversations to check progress.
Unlike traditional project management tools that require dashboards, refreshes, or manual status checks, MISO pushes state changes to the surface using emoji reactions and strategic message patterns. Your agents read SKILL.md and follow the patterns automaticallyβno Python code required.
MISO organizes communication into four distinct layers, each optimized for speed and cognitive load:
| Layer | Element | Purpose | Speed |
|---|---|---|---|
| 0 | π Pin | Presence announcement | Instant (chat open) |
| 1 | π₯ππβ Reaction | State identification | Instant (chat list) |
| 2 | Message Body | Detailed information | Read when needed |
| 3 | Inline Buttons | Actions | Execute on interaction |
The magic happens at Layer 1: You see mission state right in the chat list without opening any conversations.
- Zero-Dashboard Visibility β See all mission states from your chat list
- Reaction-Based State Machine β Emoji reactions carry semantic meaning
- OpenClaw Native β Drop it in your skills directory, configure once, done
- Design System Compliant β Follows MISO's visual and formatting standards
- WBS Master Ticket Pattern β Track complex work with strike-through updates
- Phase Templates β Consistent, emoji-rich status formats for every phase
- Extensive Reaction Mode β Full emoji reaction support required
- No Code Required β Agents read patterns from SKILL.md and follow them
# Clone the repository
git clone https://github.com/shunsukehayashi/miso.git ~/.openclaw/skills/miso
# Or install via clawhub (if available)
clawhub install misoEdit ~/.openclaw/openclaw.json to enable extensive reactions:
{
channels: {
telegram: {
reactionLevel: "extensive"
}
}
}- Start a mission with the MISO pattern
- Agents automatically apply reactions (π₯ in-progress, π pending, π complete, β failed)
- Track state from your chat listβno need to open conversations
- Use inline buttons for actions (approve, reject, etc.)
That's it. No Python imports, no setup code. Just patterns that agents follow.
Here's a sample phase message following the MISO design system:
ποΈ Phase: Implementation
β Started 2026-02-17 Β· Estimated 2026-02-20 β
Status: π₯ In Progress (Day 2 of 4)
This phase covers the core feature development:
β³ Backend API endpoints
β³ Frontend components
β³ Integration testing
Next: Validation & Review phase
πΈ α΄α΄α΄‘α΄Κα΄α΄
ΚΚ α΄ΙͺΚα΄ΚΙͺ
Key design elements:
- Em dash (
β) separators - Unicode bold where needed
- Indented hierarchy with β³
- Sakura (πΈ) footer
- Reaction-friendly structure
{
// Enable extensive reactions for full MISO support
channels: {
telegram: {
reactionLevel: "extensive"
}
},
// Optional: Configure MISO-specific settings
skills: {
miso: {
enabled: true,
reactionEmojis: {
inProgress: "π₯",
pending: "π",
complete: "π",
failed: "β",
blocked: "π«",
approved: "β
",
rejected: "π"
}
}
}
}| Emoji | Meaning | When to Use |
|---|---|---|
| π₯ | In Progress | Active work happening |
| π | Pending | Waiting on something |
| π | Complete | Phase/mission done |
| β | Failed | Hit a blocker |
| π« | Blocked | Waiting on external dependency |
| β | Approved | Green-lit to proceed |
| π | Rejected | Changes requested |
Track complex work with strike-through updates:
π WBS Master: E-Commerce Platform Migration
β Started 2026-02-10 Β· Target 2026-02-28 β
Status: π₯ In Progress (60%)
## Phase 1: Discovery [COMPLETE]
β³ ~~Audit current system~~
β³ ~~Define migration scope~~
β³ ~~Risk assessment~~
## Phase 2: Architecture [COMPLETE]
β³ ~~Design new data model~~
β³ ~~API specification~~
β³ ~~Infrastructure plan~~
## Phase 3: Implementation [IN PROGRESS]
β³ ~~Core backend services~~
β³ ~~User authentication module~~
β³ ~~Payment integration~~
β³ Order management system (active)
β³ Inventory sync
β³ ~~Frontend components~~
β³ ~~Admin dashboard~~
β³ Customer portal (active)
## Phase 4: Testing [PENDING]
β³ Unit tests
β³ Integration tests
β³ Load testing
β³ Security audit
## Phase 5: Launch [PENDING]
β³ ~~Staging deployment~~
β³ Production cutover
β³ Monitoring setup
β³ Rollback plan verification
Next: Testing phase kickoff
πΈ α΄α΄α΄‘α΄Κα΄α΄
ΚΚ α΄ΙͺΚα΄ΚΙͺ
When following MISO patterns, remember:
- Left-align only β No centering, no right alignment
- No ASCII box diagrams β Use Markdown tables instead
- Tables are OK β Markdown tables are allowed
- Code blocks are OK β For config examples, code snippets, etc.
- Emojis carry structure β Use them strategically
- Em dash separators β Use
βbetween sections - β³ for hierarchy β Indicate nested items with β³
- πΈ footer β Always end with the MISO signature
Created by Shunsuke Hayashi as part of the OpenClaw ecosystem.
Inspired by the need for mission-critical visibility without dashboard fatigue.
MIT License β See LICENSE for details.
Ready to transform your mission visibility? Install MISO and never wonder "what's the status?" again.
