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

1. Enable HTTP Chat Completions endpoint in openclaw.json:

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

2. Configure the plugin in openclaw.json:

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

3. Start the gateway and note the connection information:

openclaw lingzhu info

4. Configure Lingzhu platform with the displayed SSE endpoint and authentication key.

CLI Commands

# Display connection information
openclaw lingzhu info

# Check plugin status
openclaw lingzhu status

API Endpoint

POST /metis/agent/api/sse

• Authentication: Authorization: Bearer
• Request Format: JSON with message_id, agent_id, and messages
• Response Format: Server-Sent Events (SSE) streaming

See skill/extension/README.md for detailed API documentation and examples.

Project Structure

openclaw-lingzhu-skill/
├── skill/
│   ├── SKILL.md                    # Skill metadata and command mapping
│   ├── references/
│   │   └── install.md             # Detailed installation guide