英文 |中文

---

英语

概述

OpenClaw 灵珠技能是一个协议转换桥插件，集成了灵珠平台与OpenClaw**，实现Rokid眼镜与AI代理的无缝交互。该插件将灵珠平台的请求转换为OpenClaw兼容OpenAI的API格式，并通过AI代理路由设备命令。

主要特色

• 🔌 协议转换：无缝转换灵柱与OpenAI API格式
• 📡 SSE 流式传输：服务器发送事件（SSE）支持实时响应
• 🎯 设备集成：通过AI代理控制Rokid眼镜功能
• 📷 相机控制（拍照）
• 🗺️ 导航
• 📅 日历及提醒
• 🚪 代理会话管理
• 🔐 安全认证：基于持有令牌的认证，配备自动生成密钥
• 🌐 多模态支持：处理文本和图像输入
• 💾 图像缓存：自动图像下载和本地缓存
• 🛠️ CLI 工具：内置状态监控和配置命令

建筑

安装

快速开始

1. 在openclaw.json中启用HTTP聊天完成端点：

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