← Back to Skills Marketplace
kukuxnd

Channel Tree

by kukuxNd · GitHub ↗ · v3.1.0 · MIT-0
cross-platform ✓ Security Clean
141
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install channel-tree
Description
Manages hierarchical OpenClaw session channels to split tasks, create sub-channels, track status, and save tree state with inheritance and health monitoring.
README (SKILL.md)

Channel Tree Skill

Hierarchical management: 🏛️ Hall → 🌌 Universe → 🌍 World → 🌲 Forest → 📁 Tree → 📋 Channel

Hierarchy Levels

🏛️ Master's Hall (殿堂) - 主的领地,最大聚合
└── 🌌 Universe (宇宙) - 独立宇宙/项目
    └── 🌍 World (世界) - 大型领域/部门
        └── 🌲 Forest (森林) - 项目群/功能组
            └── 📁 Tree (树) - 单个项目/会话
                └── 📋 Channel (频道) - TASK, QA, BRANCH

Quick Commands

cd /root/.openclaw/workspace/channel_tree/

# 创建层级
python3 channel_tree.py create hall \x3Cname>
python3 channel_tree.py create universe \x3Cname> [hall_id]
python3 channel_tree.py create world \x3Cname> [universe_id]
python3 channel_tree.py create forest \x3Cname> [world_id]
python3 channel_tree.py create tree \x3Cname> [forest_id]
python3 channel_tree.py create channel \x3Ctype> \x3Cname> [parent_id]

# 查看 & 切换
python3 channel_tree.py list [id]
python3 channel_tree.py switch \x3Cpath>
python3 channel_tree.py sessions
python3 channel_tree.py context

# 监控
python3 channel_tree.py monitor

Environment Variables

CHANNEL_TREE_HALL=my-hall
CHANNEL_TREE_UNIVERSE=my-universe
CHANNEL_TREE_WORLD=my-world
CHANNEL_TREE_FOREST=my-forest
CHANNEL_TREE_SESSION=my-tree

Special Commands

->0: 整理历史记录到频率树,回到根殿堂,打印完整树结构

Channel Types

Type Purpose Token Strategy
task 工作任务 Lean context
qa 问答/咨询 Minimal context
branch 子任务分支 Inherit as needed

Inheritance Levels

  • L1 (Full): Identity, core memory, long-term goals
  • L2 (Selective): Preferences, current project context
  • L3 (On-demand): Temp data, history snippets

Health States

  • active: Normal operation
  • idle: 2+ hours no activity
  • frozen: Paused/archived
  • dead: 24+ hours no response

State File

/root/.openclaw/workspace/channel_tree/universe.json

Example Session

# 创建殿堂
python3 channel_tree.py create hall "虾3x殿堂"

# 构建下级
CHANNEL_TREE_HALL=虾3x殿堂 \
  python3 channel_tree.py create universe "当前会话"

CHANNEL_TREE_HALL=虾3x殿堂 \
CHANNEL_TREE_UNIVERSE=当前会话 \
  python3 channel_tree.py create world "服务运维"

CHANNEL_TREE_HALL=虾3x殿堂 \
CHANNEL_TREE_UNIVERSE=当前会话 \
CHANNEL_TREE_WORLD=服务运维 \
  python3 channel_tree.py create forest "游戏服务"

CHANNEL_TREE_HALL=虾3x殿堂 \
CHANNEL_TREE_UNIVERSE=当前会话 \
CHANNEL_TREE_WORLD=服务运维 \
CHANNEL_TREE_FOREST=游戏服务 \
  python3 channel_tree.py create tree "灵安城"

# 切换上下文
python3 channel_tree.py switch 游戏服务

# 查看全貌
python3 channel_tree.py list
Usage Guidance
This skill appears to do what it says: local hierarchical channel/session management stored in a JSON file. Before installing or running it, consider: 1) It will create and update /root/.openclaw/workspace/channel_tree/universe.json — if you don’t want data under /root, edit BASE_DIR in the script or run as a different user. 2) The script reads optional env vars named CHANNEL_TREE_HALL/UNIVERSE/WORLD/FOREST/SESSION (these were not listed as required in the registry metadata); setting them controls context but they are not secret. 3) There are no network calls or credential requests in the visible code, but you should review the entire script file (it was partially truncated in the manifest) to confirm there is no external communication. 4) Back up any existing universe.json before first run. If you want extra assurance, run the script in a sandboxed environment or inspect the file fully for unexpected behavior.
Capability Analysis
Type: OpenClaw Skill Name: channel-tree Version: 3.1.0 The channel-tree skill is a hierarchical organization tool for managing agent sessions and tasks across multiple levels (Hall, Universe, World, etc.). The core logic in scripts/channel_tree.py is a straightforward JSON-based state manager that tracks these hierarchies in a local file (universe.json) without any network access, sensitive data exfiltration, or dangerous command execution.
Capability Assessment
Purpose & Capability
Name/description describe hierarchical channel/session management and the included Python script implements create/list/switch/monitor operations and a JSON state file — the required files and behavior are coherent with the stated purpose.
Instruction Scope
SKILL.md instructs running the included script and setting optional CHANNEL_TREE_* environment variables. Commands and documented state path (/root/.openclaw/workspace/channel_tree/universe.json) align with the script's behavior. There are no instructions to read unrelated system files or to send data externally.
Install Mechanism
No install spec is present (instruction-only with a bundled script). No external downloads or package installs are performed by the skill, minimizing install-time risk.
Credentials
The registry declares no required environment variables but both SKILL.md and the script use optional CHANNEL_TREE_* variables (CURRENT_*). This is proportionate to the skill's purpose, but the registry metadata could have listed them. The skill does not request credentials or secret variables.
Persistence & Privilege
The skill creates and writes persistent state to /root/.openclaw/workspace/channel_tree/universe.json. always:false (not force-included) and it does not modify other skills. Users should be aware state is stored on disk (under /root by default) and may want to change BASE_DIR or run under a non-root account if that is a concern.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install channel-tree
  3. After installation, invoke the skill by name or use /channel-tree
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.1.0
Added ->0 command for history sync. Improved documentation. Multi-hall support.
v3.0.0
Added Master's Hall level: Hall→Universe→World→Forest→Tree→Channel. Multi-hall architecture.
v2.0.0
Universe→World→Forest→Tree→Channel hierarchy. Multi-level organizational structure.
v1.1.0
Multi-session isolation: each session has independent tree. Added: switch, sessions, touch commands.
v1.0.0
Initial release: hierarchical session management with L1/L2/L3 inheritance, monitoring, and Feishu integration
Metadata
Slug channel-tree
Version 3.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Channel Tree?

Manages hierarchical OpenClaw session channels to split tasks, create sub-channels, track status, and save tree state with inheritance and health monitoring. It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.

How do I install Channel Tree?

Run "/install channel-tree" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Channel Tree free?

Yes, Channel Tree is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Channel Tree support?

Channel Tree is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Channel Tree?

It is built and maintained by kukuxNd (@kukuxnd); the current version is v3.1.0.

💬 Comments