ling-openclaw (EndlessJour9527/openclaw-lingzhu-skill) | MoltPulse

Back to Directory

ling-openclaw

EndlessJour9527/openclaw-lingzhu-skill00

Molt Pulse

0

Growth0/30

Activity0/25

Popularity0/25

Trust0/20

10

Stars

High

Sentiment

Votes

10

README.md

OpenClaw Lingzhu Skill

English | 中文

English

Overview

OpenClaw Lingzhu Skill is a protocol conversion bridge plugin that integrates the Lingzhu platform (灵珠平台) with OpenClaw, enabling seamless interaction between Rokid Glasses and AI agents. The plugin converts requests from the Lingzhu platform to OpenClaw's OpenAI-compatible API format and routes device commands through the AI agent.

Key Features

🔌 Protocol Conversion: Seamlessly converts between Lingzhu and OpenAI API formats
📡 SSE Streaming: Server-Sent Events (SSE) support for real-time responses
🎯 Device Integration: Control Rokid Glasses features through AI agent
- 📷 Camera control (take photos)
- 🗺️ Navigation
- 📅 Calendar and reminders
- 🚪 Agent session management
🔐 Secure Authentication: Bearer token-based authentication with auto-generated keys
🌐 Multimodal Support: Handle text and image inputs
💾 Image Caching: Automatic image downloading and local caching
🛠️ CLI Tools: Built-in commands for status monitoring and configuration

Architecture

Rokid Glasses → Lingzhu Platform → Plugin → OpenClaw → AI Agent
                                      ↓
                               Device Commands
                        (camera, navigation, calendar)

Installation

# Install from local directory
openclaw plugins install ./skill/extension

# Or use development mode (link)
openclaw plugins install -l ./skill/extension

Quick Start

Enable HTTP Chat Completions endpoint in openclaw.json:

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

{
  "plugins": {
    "entries": {
      "lingzhu": {
        "enabled": true,
        "config": {
          "authAk": "",      // Leave empty for auto-generation
          "agentId": "main"  // Optional, defaults to "main"
        }
      }
    }
  }
}

openclaw lingzhu info

# Display connection information
openclaw lingzhu info

# Check plugin status
openclaw lingzhu status

openclaw-lingzhu-skill/
├── skill/
│   ├── SKILL.md                    # Skill metadata and command mapping
│   ├── references/
│   │   └── install.md             # Detailed installation guide
│   └── extension/                  # Main plugin code
│       ├── README.md              # Comprehensive user documentation
│       ├── package.json           # Plugin dependencies
│       ├── index.ts               # Plugin entry point
│       ├── openclaw.plugin.json   # OpenClaw plugin configuration
│       └── src/
│           ├── types.ts           # TypeScript type definitions
│           ├── config.ts          # Configuration management
│           ├── http-handler.ts    # HTTP request handling
│           ├── transform.ts       # Message format transformation
│           ├── lingzhu-tools.ts   # Device tool definitions
│           └── cli.ts             # CLI command registration

Rokid Glasses → 灵珠平台 → 插件 → OpenClaw → AI 智能体
                              ↓
                        设备命令
                 (相机、导航、日程)

# 从本地目录安装
openclaw plugins install ./skill/extension

# 或使用开发模式（链接）
openclaw plugins install -l ./skill/extension

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

{
  "plugins": {
    "entries": {
      "lingzhu": {
        "enabled": true,
        "config": {
          "authAk": "",      // 留空自动生成
          "agentId": "main"  // 可选，默认为 "main"
        }
      }
    }
  }
}

openclaw lingzhu info

# 显示连接信息
openclaw lingzhu info

# 检查插件状态
openclaw lingzhu status

openclaw-lingzhu-skill/
├── skill/
│   ├── SKILL.md                    # Skill 元数据和命令映射
│   ├── references/
│   │   └── install.md             # 详细安装指南
│   └── extension/                  # 主插件代码
│       ├── README.md              # 完整用户文档
│       ├── package.json           # 插件依赖
│       ├── index.ts               # 插件入口点
│       ├── openclaw.plugin.json   # OpenClaw 插件配置
│       └── src/
│           ├── types.ts           # TypeScript 类型定义
│           ├── config.ts          # 配置管理
│           ├── http-handler.ts    # HTTP 请求处理
│           ├── transform.ts       # 消息格式转换
│           ├── lingzhu-tools.ts   # 设备工具定义
│           └── cli.ts             # CLI 命令注册