ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified productivity Safety 4/5

unified-session

Unify all chat channels into one shared AI session for seamless cross-device continuity. Start a conversation on your laptop, continue from your phone — same context, same memory, zero loss. Use this skill whenever: - User wants multiple messaging channels (DingTalk, Feishu/Lark, Telegram, Discord, WhatsApp, Signal, Slack, webchat) to share one conversation - User mentions "shared session", "cross-device", "multi-channel", "unified session", "continue conversation", "seamless", "context lost", "memory lost", "上下文丢失", "记忆丢失", "多端共享" - User says their bot "forgets" what was said when they switch from one app to another - User asks how to make Telegram/Discord/DingTalk/Feishu/WhatsApp share context with webchat - User wants to switch between desktop and mobile without losing conversation history - User mentions dmScope, session routing, channel isolation, or session merging - User describes wanting to pick up where they left off on a different device or chat app - User complains about having separate conversations on each channel when they only have one agent - Even if the user doesn't use technical terms — if they describe the pain of "switching apps and the AI doesn't remember", this is the skill to use

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/1052326311/unified-session
Or

What This Skill Does

The unified-session skill is the definitive solution for users frustrated by the fragmentation of their AI interactions. By default, OpenClaw isolates sessions based on the channel (e.g., Telegram, Discord, or Webchat) to ensure privacy in multi-user environments. However, for personal users managing one agent across several devices, this creates a 'memory silo' effect. This skill streamlines your agent's backend by enabling a global dmScope: "main" configuration. This forces all incoming messages from your configured channels into a single, shared context buffer. Whether you are dictating notes via Telegram on the go or refining a code block in your browser, your agent will treat every interaction as part of one continuous, coherent dialogue. It eliminates the need for 'context syncing' because the context is already unified.

Installation

Installing this skill takes seconds via the OpenClaw CLI. First, ensure you have your agent configurations ready. Run the installation command: clawhub install openclaw/skills/skills/1052326311/unified-session. After installation, you should immediately update your ~/.openclaw/openclaw.json file. Set the session.dmScope key to "main". You can verify your setup by running the provided diagnostic script to ensure no individual channel is overriding the global scope with isolated settings. If you have active sessions, you may want to reset your agent memory once to ensure a clean slate for your new unified workflow.

Use Cases

This skill is perfect for:

  • The Commuter Developer: Write initial documentation on your desktop, and when you step away, continue refining the same document via Telegram on your mobile phone.
  • The Research Power-User: Keep one research context alive while switching between a laptop browser and a mobile chat app for quick reference checks.
  • The Minimalist: Maintain one single brain for your agent instead of managing disparate memory threads across three different messaging platforms.

Example Prompts

  1. "Hey, I'm switching to my phone to continue the project we were working on; remember our plan for the architecture."
  2. "Why can't you remember what I just told you on Telegram? My sessions are all over the place."
  3. "I want my Discord and Webchat to share the same history so I don't have to keep re-explaining the project context."

Tips & Limitations

Tips: Always ensure that your dmScope is applied globally in your configuration. If you notice unexpected behavior, check if individual channel configurations are hardcoded to per-channel-peer. Use the built-in diagnostic script to audit your current configuration whenever you add a new communication channel to your agent.

Limitations: This skill is designed for single-user scenarios. Do not enable dmScope: "main" if your OpenClaw agent is accessible by other people or is part of a multi-user environment. Doing so will merge all users' messages into a single shared session, causing a severe privacy risk where users could read each other's historical data.

Metadata

Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-1052326311-unified-session": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#productivity#automation#context#sync#workflow
Safety Score: 4/5

Flags: file-read, file-write