Lark CLI Dev Hub Whiteboard for Openclaw

An AI agent skill to programmatically generate and update Feishu and Lark whiteboards, transforming code-based architecture maps and flowcharts into collaborative visual assets.

afengzi
v0.1.1
May 20, 2026
0
668
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install lark-cli-devhub-whiteboard

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install lark-cli-devhub-whiteboard using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Lark CLI Dev Hub Whiteboard?

The Lark CLI Dev Hub Whiteboard skill enables developer agents to programmatically create, render, and update interactive visual diagrams directly within Feishu and Lark workspaces. This skill is part of the broader catalog of Openclaw Skills, designed to bridge the gap between codebase structures and team visualization platforms.

By converting structured text diagrams—like Mermaid syntax or DSL/SVG formats—into rich collaborative canvas boards, it helps software engineering teams keep their architecture documentation automatically synchronized with actual code changes. Instead of manually editing drawing boards, you can leverage this tool to publish system flows, bug investigation paths, and visual knowledge graphs dynamically as a part of your automated CI/CD pipelines or AI agent workflows.

Lark CLI Dev Hub Whiteboard Use Cases

  • System Architecture Mapping: Automatically render system structures with clear boundaries (3-7 zones) using Mermaid or SVG directly in Lark Whiteboards.
  • Bug Diagnosis Paths: Visually map and trace active incident investigations and debugging flowcharts to share with on-call teams.
  • Task Dependency & Release Flow Visualizations: Generate dynamic timelines, release sequences, and complex task dependencies programmatically.
  • Project Knowledge Graphs: Consolidate architectural relationships and decision impact maps into searchable, human-scannable boards.

How Lark CLI Dev Hub Whiteboard Works

  1. Diagram Definition: The developer agent creates or updates a diagram file using visual markup languages like Mermaid or DSL definitions.
  2. Local Compilation: The skill utilizes npx with @larksuite/whiteboard-cli to compile visual assets locally (e.g., transforming a .mmd script into JSON or physical image artifacts).
  3. Lark CLI Dispatch: The compiled visual data or raw content is piped into lark-cli whiteboard +update to update the designated canvas remotely with an idempotent token.
  4. Database Registry Pairing: A corresponding Base Artifacts record is registered or updated containing metadata such as Title, Project, Area, and AI Summary, ensuring the board remains indexed and discoverable for future AI agent runs.
  5. Verification Query: The skill queries or exports the updated remote board to confirm that all changes have successfully persisted.

Lark CLI Dev Hub Whiteboard Setup

To run this workspace automation, ensure you have the required CLI tools installed and configured on your host environment. This skill is highly effective when integrated into Openclaw Skills automated agent routines.

Prerequisites

Verify that you have Node.js (with npx) and lark-cli available in your system path:

# Confirm cli availability
which lark-cli
which npx

CLI Configuration Example

Use the following bash pipeline to convert a Mermaid diagram and push it directly to your remote whiteboard workspace:

# Step 1: Export Mermaid diagram to an openapi-compatible JSON format
npx -y @larksuite/whiteboard-cli@^0.2.11 \
  -i diagram.mmd --to openapi --format json \
  | lark-cli whiteboard +update \
      --whiteboard-token "$WHITEBOARD_TOKEN" \
      --source - --input_format raw \
      --idempotent-token "$(date +%s)-devhub" \
      --overwrite --dry-run --as user

Lark CLI Dev Hub Whiteboard Data Schema & Taxonomy

Whiteboard Metadata Registry

To ensure future AI systems and developers can locate active whiteboards without needing manual search, every durable canvas must be paired with a Base registry entry containing the following schema:

Attribute Description Example
Title Descriptive title of the visual map User Authentication Flow
Project Parent project or repository identifier Auth-Gateway
Area Specific system domain or team scope Security & Auth
Artifact Type Must be explicitly set to evaluate discovery Whiteboard
Source URL Direct link to the remote Feishu/Lark canvas https://feishu.cn/space/wb/...
Summary Brief human-readable description Visual routing flows for security group mapping.
AI Summary Machine-readable breakdown of the contents Mermaid flow illustrating token lifecycle stages.
Search Keywords Comma-separated tags to aid system discoverability oauth, token, login, architecture

Visual Formatting Best Practices

  • Simple Flows: Use Mermaid for timelines, sequence diagrams, and mind maps.
  • Dense Graphics: Use SVG or visual DSL for complex node-based architecture diagrams with high-density grouping to avoid all-to-all edges.

Lark CLI Dev Hub Whiteboard Advanced Features

  • Idempotent Updates: Prevents redundant changes by assigning unique, timestamp-based idempotency tokens during CLI commits.
  • Dry-Run Validation: Offers a --dry-run validation flag to preview structure integrity prior to committing modifications in live production collaborative channels.
  • Artifact Registry Interoperability: Seamlessly couples visual assets with base discovery records so that secondary Openclaw Skills can locate and read diagram scopes automatically.
  • Workspace Identity Context: Executes commands inside user-specific spaces via the --as user delegation flag, maintaining clear audit logs.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*