@honor-claw/yoyo 0.0.1-beta.4 → 0.0.1-beta.6

package/index.ts

@@ -2,7 +2,7 @@ import { type OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { setYoyoRuntime } from "./src/runtime.js";
 import { registerCommands } from "./src/commands/index.js";
 import { YoyoPluginConfigSchema } from "./src/schemas.js";
-import { ClawConnectionService } from "./src/services/connection/index.js";
+import { createClawConnectionService } from "./src/services/connection/index.js";
 import { setClawLogger } from "./src/utils/logger.js";
 
 const plugin = {
@@ -15,7 +15,7 @@ const plugin = {
     setClawLogger(api.logger);
 
     // 利用服务来管理核心连接任务进行~
-    api.registerService(ClawConnectionService);
+    api.registerService(createClawConnectionService(api));
 
     // 注册所有的命令行
     registerCommands(api);

package/openclaw.plugin.json

@@ -22,6 +22,10 @@
           }
         },
         "additionalProperties": false
+      },
+      "env": {
+        "type": "string",
+        "enum": ["test", "production"]
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "0.0.1-beta.4",
+  "version": "0.0.1-beta.6",
   "type": "module",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "scripts": {
@@ -30,7 +30,6 @@
     ]
   },
   "dependencies": {
-    "@sinclair/typebox": "0.34.48",
     "http-proxy-agent": "^8.0.0",
     "https-proxy-agent": "^8.0.0",
     "jsonwebtoken": "^9.0.3",
@@ -47,6 +46,7 @@
     "@types/ws": "^8.5.13",
     "@vitest/coverage-v8": "^2.1.8",
     "commander": "^14.0.3",
+    "openclaw": "2026.3.8",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.8"

package/skills/search/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: search
+description: "Search the web using Tavily's LLM-optimized search API. Returns relevant results with content snippets, scores, and metadata. Use when you need to find web content on any topic without writing code."
+---
+
+# Search Skill
+
+Search the web and get relevant results optimized for LLM consumption.
+
+## Authentication
+
+The script uses OAuth via the Tavily MCP server. **No manual setup required** - on first run, it will:
+1. Check for existing tokens in `~/.mcp-auth/`
+2. If none found, automatically open your browser for OAuth authentication
+
+> **Note:** You must have an existing Tavily account. The OAuth flow only supports login — account creation is not available through this flow. [Sign up at tavily.com](https://tavily.com) first if you don't have an account.
+
+### Alternative: API Key
+
+If you prefer using an API key, get one at https://tavily.com and add to `~/.claude/settings.json`:
+```json
+{
+  "env": {
+    "TAVILY_API_KEY": "tvly-your-api-key-here"
+  }
+}
+```
+
+## Quick Start
+
+### Using the Script
+
+```bash
+./scripts/search.sh '<json>'
+```
+
+**Examples:**
+```bash
+# Basic search
+./scripts/search.sh '{"query": "python async patterns"}'
+
+# With options
+./scripts/search.sh '{"query": "React hooks tutorial", "max_results": 10}'
+
+# Advanced search with filters
+./scripts/search.sh '{"query": "AI news", "time_range": "week", "max_results": 10}'
+
+# Domain-filtered search
+./scripts/search.sh '{"query": "machine learning", "include_domains": ["arxiv.org", "github.com"], "search_depth": "advanced"}'
+```
+
+### Basic Search
+
+```bash
+curl --request POST \
+  --url https://api.tavily.com/search \
+  --header "Authorization: Bearer $TAVILY_API_KEY" \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "query": "latest developments in quantum computing",
+    "max_results": 5
+  }'
+```
+
+### Advanced Search
+
+```bash
+curl --request POST \
+  --url https://api.tavily.com/search \
+  --header "Authorization: Bearer $TAVILY_API_KEY" \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "query": "machine learning best practices",
+    "max_results": 10,
+    "search_depth": "advanced",
+    "include_domains": ["arxiv.org", "github.com"]
+  }'
+```
+
+## API Reference
+
+### Endpoint
+
+```
+POST https://api.tavily.com/search
+```
+
+### Headers
+
+| Header | Value |
+|--------|-------|
+| `Authorization` | `Bearer <TAVILY_API_KEY>` |
+| `Content-Type` | `application/json` |
+
+### Request Body
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `query` | string | Required | Search query (keep under 400 chars) |
+| `max_results` | integer | 10 | Maximum results (0-20) |
+| `search_depth` | string | `"basic"` | `ultra-fast`, `fast`, `basic`, `advanced` |
+| `topic` | string | `"general"` | Search topic (general only) |
+| `time_range` | string | null | `day`, `week`, `month`, `year` |
+| `start_date` | string | null | Return results after this date (`YYYY-MM-DD`) |
+| `end_date` | string | null | Return results before this date (`YYYY-MM-DD`) |
+| `include_domains` | array | [] | Domains to include (max 300) |
+| `exclude_domains` | array | [] | Domains to exclude (max 150) |
+| `country` | string | null | Boost results from a specific country (general topic only) |
+| `include_raw_content` | boolean | false | Include full page content |
+| `include_images` | boolean | false | Include image results |
+| `include_image_descriptions` | boolean | false | Include descriptions for images |
+| `include_favicon` | boolean | false | Include favicon URL for each result |
+
+### Response Format
+
+```json
+{
+  "query": "latest developments in quantum computing",
+  "results": [
+    {
+      "title": "Page Title",
+      "url": "https://example.com/page",
+      "content": "Extracted text snippet...",
+      "score": 0.85
+    }
+  ],
+  "response_time": 1.2
+}
+```
+
+## Search Depth
+
+| Depth | Latency | Relevance | Content Type |
+|-------|---------|-----------|--------------|
+| `ultra-fast` | Lowest | Lower | NLP summary |
+| `fast` | Low | Good | Chunks |
+| `basic` | Medium | High | NLP summary |
+| `advanced` | Higher | Highest | Chunks |
+
+**When to use each:**
+- `ultra-fast`: Real-time chat, autocomplete
+- `fast`: Need chunks but latency matters
+- `basic`: General-purpose, balanced
+- `advanced`: Precision matters (default recommendation)
+
+## Examples
+
+### Domain-Filtered Search
+
+```bash
+curl --request POST \
+  --url https://api.tavily.com/search \
+  --header "Authorization: Bearer $TAVILY_API_KEY" \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "query": "Python async best practices",
+    "include_domains": ["docs.python.org", "realpython.com", "github.com"],
+    "search_depth": "advanced"
+  }'
+```
+
+### Search with Full Content
+
+```bash
+curl --request POST \
+  --url https://api.tavily.com/search \
+  --header "Authorization: Bearer $TAVILY_API_KEY" \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "query": "React hooks tutorial",
+    "max_results": 3,
+    "include_raw_content": true
+  }'
+```
+
+## Tips
+
+- **Keep queries under 400 characters** - Think search query, not prompt
+- **Break complex queries into sub-queries** - Better results than one massive query
+- **Use `include_domains`** to focus on trusted sources
+- **Use `time_range`** for recent information
+- **Filter by `score`** (0-1) to get highest relevance results

package/skills/search/scripts/search.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# Tavily Search API script
+# Usage: ./search.sh '{"query": "your search query", ...}'
+# Example: ./search.sh '{"query": "AI news", "time_range": "week", "max_results": 10}'
+
+set -e
+
+# Check for TAVILY_API_KEY environment variable
+if [ -z "$TAVILY_API_KEY" ]; then
+    echo "Error: TAVILY_API_KEY environment variable is required" >&2
+    echo "Please set it: export TAVILY_API_KEY='your-api-key'" >&2
+    exit 1
+fi
+
+JSON_INPUT="$1"
+
+if [ -z "$JSON_INPUT" ]; then
+    echo "Usage: ./search.sh '<json>'"
+    echo ""
+    echo "Required:"
+    echo "  query: string - Search query (keep under 400 chars)"
+    echo ""
+    echo "Optional:"
+    echo "  search_depth: \"ultra-fast\", \"fast\", \"basic\" (default), \"advanced\""
+    echo "  topic: \"general\" (default)"
+    echo "  max_results: 1-20 (default: 10)"
+    echo "  time_range: \"day\", \"week\", \"month\", \"year\""
+    echo "  start_date: \"YYYY-MM-DD\""
+    echo "  end_date: \"YYYY-MM-DD\""
+    echo "  include_domains: [\"domain1.com\", \"domain2.com\"]"
+    echo "  exclude_domains: [\"domain1.com\", \"domain2.com\"]"
+    echo "  country: country name (general topic only)"
+    echo "  include_raw_content: true/false"
+    echo "  include_images: true/false"
+    echo "  include_image_descriptions: true/false"
+    echo "  include_favicon: true/false"
+    echo ""
+    echo "Example:"
+    echo "  ./search.sh '{\"query\": \"latest AI trends\", \"time_range\": \"week\"}'"
+    exit 1
+fi
+
+MCP_REQUEST='{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "tools/call",
+  "params": {
+    "name": "tavily_search",
+    "arguments": '"$JSON_INPUT"'
+  }
+}'
+
+# Call Tavily MCP server via HTTPS
+RESPONSE=$(curl -s --request POST \
+    --url "https://mcp.tavily.com/mcp" \
+    --header "Authorization: Bearer $TAVILY_API_KEY" \
+    --header 'Content-Type: application/json' \
+    --header 'Accept: application/json, text/event-stream' \
+    --header 'x-client-source: claude-code-skill' \
+    --data "$MCP_REQUEST")
+
+# Parse SSE response and extract the JSON result
+JSON_DATA=$(echo "$RESPONSE" | grep '^data:' | sed 's/^data://' | head -1)
+
+if [ -n "$JSON_DATA" ]; then
+    echo "$JSON_DATA"
+else
+    echo "$RESPONSE"
+fi

package/skills/yoyo-control/SKILL.md

@@ -5,7 +5,7 @@ description: Whenever a task requires **operating or controlling the phone**, eg
 metadata: { "openclaw": { "emoji": "📱", "always": true } }
 ---
 
-# Control phone with YOYO
+# YOYO Control
 
 Follow the workflow to control phone or pad with YOYO, Don't guess the commands.
 
@@ -13,9 +13,9 @@ Follow the workflow to control phone or pad with YOYO, Don't guess the commands.
 
 Follow this **4-step workflow** when using the skill:
 
-1. Query the device status to identify available device nodes.
-2. Determine the target node, required tool, and execution parameters based on the user's intent.
-3. Call the node tool using the correct parameter format.
+1. Query the nodes status to identify available device, and determine the target device.
+2. Plan the tool to use, and extract command & parameters according to the tool reference.
+3. Invoke node with correct nodeId, command and parameters.
 4. Present the result and confirm whether the operation was successful.
 
 ### Step 1. Discover Nodes
@@ -26,9 +26,11 @@ Follow this **4-step workflow** when using the skill:
 
 **Execution result**:
 
+```markdown
 | Node       | ID       | IP       | Detail   | Status   | Caps   |
 | ---------- | -------- | -------- | -------- | -------- | ------ |
 | <nodeName> | <nodeId> | <nodeIP> | <detail> | <status> | <caps> |
+```
 
 #### Capability Matching Logic
 
@@ -74,17 +76,19 @@ Before executing any device control operation, you **MUST** consult the correspo
 
 ### Available Tool References
 
-| Reference File                     | Capability       | Description                                                                                                                                                          | Required Node Caps     |
-| ---------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
-| `references/volume.md`             | Volume Control   | Adjust, set, increase, decrease, mute/unmute device volume; query current volume status; fine-grained control by stream type (media, call, ringtone, notification)   | `volume.operate`       |
-| `references/phone-call.md`         | Phone Call       | Initiate and manage phone calls; unified control for call operations                                                                                                 | `phone.call`           |
-| `references/screen-recorder.md`    | Screen Recording | Start/stop screen recording; configure recording parameters; query recording status; app-specific recording control                                                  | `screen.record`        |
-| `references/capture-screenshot.md` | Screenshot       | Capture current screen content as image; support standard and scrolling screenshot modes                                                                             | `capture.shot`         |
-| `references/schedule.md`           | Schedule         | Provides the ability to create schedules                                                                                                                             | `schedule.create`      |
-| `references/search-contact.md`     | Contact          | Provides the ability to search contacts                                                                                                                              | `search.contact `      |
-| `references/open-app.md`           | Open Application | Used to help users open a specified app without any specific app internals.                                                                                          | `app.open`             |
-| `references/send-message.md`       | Send Message     | Provide SMS sending services, users can send SMS content to specified numbers by providing phone numbers or contact information.                                     | `send.message`         |
-| `references/local-search.md`       | Local Search     | Search native data for documents, notes, calendars, galleries, yoyo memories, wallets, and more for direct answers to user questions or generate at-a-glance content | `message.send.message` |
+| Reference File                     | Tool Name               | Description                                                                                                                                                          | Required Node Caps |
+| ---------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
+| `references/volume.md`             | volume                  | Adjust, set, increase, decrease, mute/unmute device volume; query current volume status; fine-grained control by stream type (media, call, ringtone, notification)   | `volume.operate`   |
+| `references/phone-call.md`         | phone_call              | Initiate and manage phone calls; unified control for call operations                                                                                                 | `phone.call`       |
+| `references/screen-recorder.md`    | screen_recorder         | Start/stop screen recording; configure recording parameters; query recording status; app-specific recording control                                                  | `screen.record`    |
+| `references/capture-screenshot.md` | capture_screenshot      | Capture current screen content as image; support standard and scrolling screenshot modes                                                                             | `capture.shot`     |
+| `references/schedule.md`           | Schedschedule_createule | Provides the ability to create schedules                                                                                                                             | `schedule.create`  |
+| `references/search-contact.md`     | search_contact          | Provides the ability to search contacts                                                                                                                              | `search.contact `  |
+| `references/open-app.md`           | open_app                | Used to help users open a specified app without any specific app internals.                                                                                          | `app.open`         |
+| `references/send-message.md`       | send_message            | Provide SMS sending services, users can send SMS content to specified numbers by providing phone numbers or contact information.                                     | `send.message`     |
+| `references/local-search.md`       | local_search            | Search native data for documents, notes, calendars, galleries, yoyo memories, wallets, and more for direct answers to user questions or generate at-a-glance content | `loacal.search`    |
+| `references/hot-spot.md`           | hot_spot                | 手机热点控制能力                                                                                                                                                     | `hot.spot`         |
+| `references/no-disturb.md`         | hot_spot                | 手机勿扰模式控制力                                                                                                                                                   | `no.disturb`       |
 
 ### Parameter Construction Workflow
 
@@ -181,17 +185,32 @@ Execute the following steps **in strict order** for each operation:
 
 ### Parameter Format Requirements
 
-| Platform                     | Format                                  | Example                 |
-| ---------------------------- | --------------------------------------- | ----------------------- |
-| **Bash (Linux/macOS)**       | Single quotes wrapping JSON             | `'{"level":50}'`        |
-| **Windows (PowerShell/CMD)** | Double quotes with escaped inner quotes | `"{\"level\":50}"`      |
-| **Complex Objects**          | Create JSON file first                  | `--params @params.json` |
+**Platform-specific JSON parameter format:**
+
+| Platform    | Shell | Quote Style                     | Example                         |
+| ----------- | ----- | ------------------------------- | ------------------------------- |
+| **Windows** | CMD   | Double quotes, escape inner `"` | `"{\"actionType\":\"打电话\"}"` |
+| **Linux**   | Bash  | Single quotes                   | `'{"actionType":"打电话"}'`     |
+| **macOS**   | Bash  | Single quotes                   | `'{"actionType":"打电话"}'`     |
+
+**Windows CMD Execution:**
+
+```cmd
+openclaw nodes invoke <nodeId> --command phone.call --params "{\"actionType\":\"打电话\",\"phoneNumber\":\"10086\"}"
+```
+
+**Linux/macOS Bash Execution:**
+
+```bash
+openclaw nodes invoke <nodeId> --command phone.call --params '{"actionType":"打电话","phoneNumber":"10086"}'
+```
 
 **Additional Requirements**:
 
 - Parameters must be valid JSON
 - Enum values must match documentation exactly (case-sensitive)
 - Numeric values must be within defined ranges
+- On Windows, always use CMD (not PowerShell) to avoid quote parsing issues
 
 ### Examples
 
@@ -334,13 +353,3 @@ Would you like to check other nodes or retry later?"
 - ❌ **DO NOT** expose raw error codes to users
 - ❌ **DO NOT** assume user knows technical details
 - ❌ **DO NOT** leave user without next steps on failure
-
-## 快速参考命令
-
-```bash
-# 获取所有节点状态
-openclaw nodes status
-
-# 调用工具
-openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
-```

package/skills/yoyo-control/references/hot-spot.md

@@ -0,0 +1,19 @@
+# hot_spot 手机热点控制工具使用说明
+
+## Tool Command
+
+```bash
+hot.spot
+```
+
+## Tool Parameters and Examples
+
+```json
+{
+  "name": "hot_spot",
+  "description": "该工具提供对设备热点控制",
+  "parameters": {},
+  "required": [],
+  "examples": []
+}
+```

package/skills/yoyo-control/references/no-disturb.md

@@ -0,0 +1,19 @@
+# no_disturb 勿扰模式工具使用说明
+
+## Tool Command
+
+```bash
+no.disturb
+```
+
+## Tool Parameters and Examples
+
+```json
+{
+  "name": "no_disturb",
+  "description": "手机勿扰模式",
+  "parameters": {},
+  "required": [],
+  "examples": []
+}
+```

package/skills/yoyo-control/references/phone-call.md

@@ -65,7 +65,7 @@ phone.call
 ```json
 {
   "name": "phone_call",
-  "description": "提供打电话能力，支持指定姓名、电话号码电话；支持选择打电话的卡；支持重拨、回拨已接听来电、回拨未接听来电、回拨电话",
+  "description": "提供打电话的功能，支持指定姓名、电话号码；支持选择打电话的卡；支持重拨、回拨已接听来电、回拨未接听来电、回拨电话",
   "parameters": {
     "actionType": {
       "type": "string",
@@ -91,125 +91,38 @@ phone.call
     },
     "contact": {
       "type": "string",
-      "description": "泛化的"联系人"概念，可为：自然人名或昵称（如：张三、王总）、非自然实体（机构、部门、服务名称，如：招生办、物业客服）"
+      "description": "泛化的“联系人”概念，可为：自然人名或昵称（如：张三、王总）、非自然实体（机构、部门、服务名称，如：招生办、物业客服）"
     }
   },
   "examples": [
     {
-      "scenario": "User provides phoneNumber directly",
-      "query": "打电话给15651621029",
-      "workflow": "Direct call (no contact search needed)",
+      "query": "拨打电话",
       "arguments": {
-        "actionType": "打电话",
-        "phoneNumber": "15651621029"
-      }
-    },
-    {
-      "scenario": "User provides contact name only",
-      "query": "打电话给妈妈",
-      "workflow": "search_contact → phone.call",
-      "step1": {
-        "tool": "search_contact",
-        "arguments": {
-          "contact": "妈妈"
-        },
-        "result": {
-          "name": "妈妈",
-          "phoneNumber": "13900139000"
-        }
-      },
-      "step2": {
-        "tool": "phone.call",
-        "arguments": {
-          "actionType": "打电话",
-          "phoneNumber": "13900139000"
-        }
+        "actionType": "打电话"
       }
     },
     {
-      "scenario": "User provides contact with phoneCard",
-      "query": "用移动卡打电话给张三",
-      "workflow": "search_contact → phone.call with phoneCard",
-      "step1": {
-        "tool": "search_contact",
-        "arguments": {
-          "contact": "张三"
-        },
-        "result": {
-          "name": "张三",
-          "phoneNumber": "15651621029"
-        }
-      },
-      "step2": {
-        "tool": "phone.call",
-        "arguments": {
-          "actionType": "打电话",
-          "phoneNumber": "15651621029",
-          "phoneCard": "移动"
-        }
-      }
-    },
-    {
-      "scenario": "User requests redial",
-      "query": "重拨",
-      "workflow": "Direct redial (no contact search needed)",
+      "query": "打电话给15651621029",
       "arguments": {
-        "actionType": "重拨"
+        "actionType": "打电话",
+        "phoneNumber": "15651621029"
       }
     },
     {
-      "scenario": "User requests callback missed call",
-      "query": "回拨未接来电",
-      "workflow": "Direct callback (no contact search needed)",
+      "query": "打电话给张三",
       "arguments": {
-        "actionType": "回拨",
-        "recallType": "回拨未接听来电"
-      }
-    },
-    {
-      "scenario": "User provides contact with multiple matches",
-      "query": "打电话给李四",
-      "workflow": "search_contact → user selects → phone.call",
-      "step1": {
-        "tool": "search_contact",
-        "arguments": {
-          "contact": "李四"
-        },
-        "result": {
-          "matches": [
-            { "name": "李四(公司)", "phoneNumber": "13800138001" },
-            { "name": "李四(家里)", "phoneNumber": "13800138002" }
-          ]
-        }
-      },
-      "step2": {
-        "action": "Ask user to select",
-        "prompt": "找到多个李四，请选择：1. 李四(公司) 2. 李四(家里)"
-      },
-      "step3": {
-        "tool": "phone.call",
-        "arguments": {
-          "actionType": "打电话",
-          "phoneNumber": "13800138001"
-        }
+        "actionType": "打电话",
+        "contact": "张三",
+        "phoneNumber": "15651621029"
       }
     },
     {
-      "scenario": "User provides contact with no match",
-      "query": "打电话给王五",
-      "workflow": "search_contact → no match → ask for phoneNumber",
-      "step1": {
-        "tool": "search_contact",
-        "arguments": {
-          "contact": "王五"
-        },
-        "result": {
-          "matches": []
-        }
-      },
-      "step2": {
-        "action": "Ask user for phoneNumber",
-        "prompt": "未找到联系人王五，请提供电话号码"
+      "query": "用移动手机卡打电话给于洋",
+      "arguments": {
+        "actionType": "打电话",
+        "contact": "张三",
+        "phoneNumber": "15651621029",
+        "phoneCard": "移动手机卡"
       }
     }
   ]

package/skills/yoyo-control/references/volume.md

@@ -1,6 +1,6 @@
 # volumn 音量控制工具使用说明
 
-## 工具指令 command 定义
+## Tool Command
 
 ```bash
 volume.operate