@honor-claw/yoyo 0.0.1-alpha.0

package/skills/yoyo-control/scripts/invoke.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/**
+ * Device Control Invoke Script
+ *
+ * 封装 openclaw nodes invoke 命令，提供统一的设备控制接口
+ * 使用配置文件方式避免 Windows PowerShell 对 JSON 参数的引号处理问题
+ */
+
+import { exec } from "child_process";
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import { promisify } from "util";
+
+const execAsync = promisify(exec);
+
+/**
+ * 显示使用说明
+ */
+function usage() {
+  console.error("用法: node invoke.js <config_file> [--debug]");
+  console.error("");
+  console.error("参数:");
+  console.error("  config_file - JSON 配置文件路径");
+  console.error("  --debug     - 启用调试模式");
+  console.error("");
+  console.error("配置文件格式:");
+  console.error("{");
+  console.error('  "nodeId": "设备ID",');
+  console.error('  "command": "命令标识",');
+  console.error('  "params": { ...参数对象 }');
+  console.error("}");
+  console.error("");
+  console.error("示例:");
+  console.error("  node invoke.js config.json");
+  console.error("  node invoke.js config.json --debug");
+  process.exit(2);
+}
+
+/**
+ * 执行节点命令
+ */
+async function invokeNode(nodeId, command, params, timeout = 15000, debug = false) {
+  const paramsStr = JSON.stringify(params);
+  const cmd = `npx openclaw nodes invoke --node ${nodeId} --command ${command} --params "${paramsStr.replace(/"/g, '\\"')}"`;
+
+  if (debug) {
+    console.log("=== 调试信息 ===");
+    console.log("执行命令:", cmd);
+    console.log("设备 ID:", nodeId);
+    console.log("命令标识:", command);
+    console.log("参数对象:", JSON.stringify(params, null, 2));
+    console.log("================");
+  }
+
+  try {
+    const { stdout, stderr } = await execAsync(cmd, {
+      timeout,
+      env: { ...process.env },
+      cwd: process.cwd()
+    });
+
+    if (debug) {
+      console.log("=== 执行结果 ===");
+      console.log("标准输出:", stdout.trim());
+      console.log("错误输出:", stderr.trim());
+      console.log("================");
+    }
+
+    return {
+      success: true,
+      data: stdout.trim(),
+      error: stderr.trim() || null
+    };
+  } catch (error) {
+    if (debug) {
+      console.log("=== 执行失败 ===");
+      console.log("错误信息:", error.message);
+      console.log("标准输出:", error.stdout?.trim() || "");
+      console.log("错误输出:", error.stderr?.trim() || "");
+      console.log("================");
+    }
+
+    return {
+      success: false,
+      data: error.stdout?.trim() || "",
+      error: error.stderr?.trim() || error.message
+    };
+  }
+}
+
+// 主程序
+const args = process.argv.slice(2);
+const debugIndex = args.indexOf("--debug");
+const debug = debugIndex !== -1;
+if (debug) args.splice(debugIndex, 1);
+
+if (args.length === 0 || args[0] === "-h" || args[0] === "--help") {
+  usage();
+}
+
+const configPath = resolve(args[0]);
+
+try {
+  const configContent = readFileSync(configPath, "utf-8");
+  const config = JSON.parse(configContent);
+  const { nodeId, command, params } = config;
+
+  if (!nodeId || !command) {
+    console.error("错误: 配置文件缺少必要字段: nodeId 或 command");
+    process.exit(1);
+  }
+
+  const result = await invokeNode(nodeId, command, params || {}, 15000, debug);
+  console.log(JSON.stringify(result, null, 2));
+  process.exit(result.success ? 0 : 1);
+} catch (error) {
+  console.error(`错误: ${error.message}`);
+  process.exit(1);
+}

package/skills/yoyo-control/scripts/volume-up.json

@@ -0,0 +1,7 @@
+{
+  "nodeId": "YOUR_DEVICE_ID",
+  "command": "volume.operate",
+  "params": {
+    "actionType": "调大"
+  }
+}

package/src/apis/claw-cloud.ts

@@ -0,0 +1,74 @@
+/**
+ * Claw Cloud API 接口封装
+ */
+import type { DeviceInfo, HonorUserInfo } from '../types.js';
+import type { GatewayAuthConfig } from '../modules/claw-configs/types.js';
+import { uuid } from '../utils/id.js';
+import { generateAuthorization } from '../utils/jwt.js';
+import { HttpClient, type HttpResponse, type HttpClientOptions } from './http-client.js';
+import type { DeviceRegistryHeaders, DeviceRegistryRequest, DeviceRegistryResponse } from './types.js';
+
+/**
+ * Claw Cloud API 客户端
+ */
+export class ClawCloudClient {
+  private httpClient: HttpClient;
+
+  constructor(baseUrl: string, options?: HttpClientOptions) {
+    this.httpClient = new HttpClient(baseUrl, options);
+  }
+
+  /**
+   * 设备注册
+   * @param deviceInfo 设备信息
+   * @param userInfo 用户信息
+   * @param gatewayAuthConfig Gateway 认证配置（可选）
+   * @returns 注册响应
+   */
+  async registerDevice(
+    deviceInfo: DeviceInfo,
+    userInfo: HonorUserInfo,
+    gatewayAuthConfig?: GatewayAuthConfig
+  ): Promise<HttpResponse<DeviceRegistryResponse>> {
+    // 构造请求头
+    const headers: DeviceRegistryHeaders = {
+      'x-trace-id': uuid(),
+      'x-udid': deviceInfo.deviceId,
+      ...(userInfo.token && userInfo.token !== 'test'
+        ? {
+            'x-jwt-token': userInfo.token,
+          }
+        : {
+            'x-agw-userId': userInfo.userId,
+          }),
+      authorization: generateAuthorization(userInfo.userId),
+    };
+
+    const requestBody: DeviceRegistryRequest = {
+      businessTag: 'YOYO_CLAW',
+      role: 'yoyoclaw',
+      deviceInfo: {
+        ...deviceInfo,
+        userId: userInfo.userId,
+        /**
+         * todo 后面网关会去掉检查
+         */
+        manufacture: 'unknown',
+        brand: 'honor',
+        bizExtInfo: gatewayAuthConfig,
+      } as any,
+    };
+
+    return this.httpClient.post<DeviceRegistryResponse>('/v1/device/registry', {
+      headers: headers as unknown as Record<string, string>,
+      body: requestBody,
+    });
+  }
+}
+
+/**
+ * 创建 Claw Cloud 客户端实例
+ */
+export function createClawCloudClient(baseUrl: string, options?: HttpClientOptions): ClawCloudClient {
+  return new ClawCloudClient(baseUrl, options);
+}

package/src/apis/helpers.ts

@@ -0,0 +1,10 @@
+import type { HttpResponse } from './http-client.js';
+import type { HttpApiWrapper } from './types.js';
+
+export function isOKResponse<T>(response: HttpResponse<HttpApiWrapper<T>>) {
+  if (response.status >= 200 && response.status < 300 && response.data.code === '1') {
+    return true;
+  }
+
+  return false;
+}

package/src/apis/honor-auth.ts

@@ -0,0 +1,148 @@
+/**
+ * 荣耀OAuth2认证客户端
+ * 提供授权URL构建、Token获取等API能力
+ */
+
+import { createHash, randomBytes } from 'crypto';
+import { HttpClient, type HttpClientOptions } from './http-client.js';
+import type { TokenResponse, HonorAuthConfig } from '../honor-auth/types.js';
+import { uuid } from '../utils/id.js';
+import { isOKResponse } from './helpers.js';
+import type { HttpApiWrapper } from './types.js';
+
+/**
+ * PKCE参数
+ */
+export interface PKCEParams {
+  codeVerifier: string;
+  codeChallenge: string;
+}
+
+/**
+ * 荣耀认证客户端
+ */
+export class HonorAuthClient {
+  private httpClient: HttpClient;
+  private config: HonorAuthConfig;
+
+  constructor(config: HonorAuthConfig) {
+    this.config = config;
+    // 从 HonorAuthConfig 中提取 HttpClientOptions
+    const httpClientOptions: HttpClientOptions = {
+      proxy: config.proxy,
+    };
+    this.httpClient = new HttpClient(config.authHost, httpClientOptions);
+  }
+
+  /**
+   * 生成随机字符串
+   */
+  private generateRandomString(length: number): string {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    const bytes = randomBytes(length);
+    let result = '';
+    for (let i = 0; i < length; i++) {
+      result += chars[bytes[i] % chars.length];
+    }
+    return result;
+  }
+
+  /**
+   * 生成PKCE code_verifier
+   */
+  generateCodeVerifier(length: number = 128): string {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~';
+    const bytes = randomBytes(length);
+    let result = '';
+    for (let i = 0; i < length; i++) {
+      result += chars[bytes[i] % chars.length];
+    }
+    return result;
+  }
+
+  /**
+   * 生成PKCE code_challenge
+   */
+  generateCodeChallenge(verifier: string): string {
+    const hash = createHash('sha256').update(verifier).digest();
+    return hash.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+  }
+
+  /**
+   * 生成PKCE参数
+   */
+  generatePKCEParams(): PKCEParams {
+    const codeVerifier = this.generateCodeVerifier();
+    const codeChallenge = this.generateCodeChallenge(codeVerifier);
+    return { codeVerifier, codeChallenge };
+  }
+
+  /**
+   * 构建授权URL
+   */
+  buildAuthUrl(pkceParams: PKCEParams): string {
+    const params = new URLSearchParams({
+      client_id: this.config.clientId,
+      redirect_uri: this.config.redirectUri,
+      scope: this.config.scope,
+      response_type: 'code',
+      access_type: 'offline',
+      state: this.generateRandomString(16),
+      reqClientType: this.config.reqClientType,
+      loginChannel: this.config.loginChannel,
+      code_challenge: pkceParams.codeChallenge,
+      code_challenge_method: 'S256',
+    });
+
+    return `${this.config.authHost}/oauth2/v3/authorize?${params.toString()}`;
+  }
+
+  /**
+   * 使用授权码换取Token
+   */
+  async exchangeToken(code: string) {
+    const tokenUrl = 'https://api-agd-test-drcn.hiboard.hihonorcloud.com/honorboard/auth/v1/oauth/jwtToken';
+
+    const data = {
+      clientId: this.config.clientId,
+      code,
+      redirectUri: this.config.redirectUri,
+    };
+
+    try {
+      const response = await this.httpClient.post<HttpApiWrapper<TokenResponse>>(tokenUrl, {
+        body: data,
+        headers: {
+          'Content-Type': 'application/json',
+          'x-origin-udid': this.config.clientId,
+          'x-app-pkg': 'com.hihonor.pc.openclaw',
+          'x-request-nonce': uuid(),
+          'x-timestamp': String(Date.now()),
+        },
+        timeout: 15000,
+      });
+
+      if (isOKResponse(response)) {
+        return response.data.data;
+      }
+
+      throw new Error(`获取Token失败: ${response.data?.cnMessage}`);
+    } catch (error) {
+      throw new Error(`获取Token失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  /**
+   * 获取配置
+   */
+  getConfig(): HonorAuthConfig {
+    return { ...this.config };
+  }
+}
+
+/**
+ * 创建荣耀认证客户端
+ */
+export function createHonorAuthClient(config: HonorAuthConfig): HonorAuthClient {
+  return new HonorAuthClient(config);
+}

package/src/apis/http-client.ts

@@ -0,0 +1,239 @@
+/**
+ * HTTP 请求客户端封装
+ * 基于 undici 实现
+ */
+
+import { request, type Dispatcher, ProxyAgent } from "undici";
+import { getProxyUrl, shouldUseProxy } from "../utils/proxy.js";
+
+/**
+ * HTTP 客户端配置
+ */
+export interface HttpClientOptions {
+  defaultHeaders?: Record<string, string>;
+  defaultTimeout?: number;
+  /**
+   * 代理地址，例如：http://127.0.0.1:7890
+   * 如果不设置，则使用环境变量 HTTP_PROXY 或 HTTPS_PROXY
+   */
+  proxy?: string;
+}
+
+/**
+ * HTTP 请求配置
+ */
+export interface HttpRequestConfig {
+  url: string;
+  method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+  headers?: Record<string, string>;
+  body?: string | object | null;
+  timeout?: number;
+  query?: Record<string, string | number | boolean | undefined>;
+  /**
+   * 是否禁用代理（默认 false）
+   */
+  disableProxy?: boolean;
+}
+
+/**
+ * HTTP 响应
+ */
+export interface HttpResponse<T = unknown> {
+  data: T;
+  status: number;
+  headers: Record<string, string | string[] | undefined>;
+}
+
+/**
+ * HTTP 错误
+ */
+export class HttpError extends Error {
+  constructor(public status: number, public data: unknown, message: string) {
+    super(message);
+    this.name = "HttpError";
+  }
+}
+
+/**
+ * HTTP 客户端类
+ */
+export class HttpClient {
+  private baseUrl: string;
+  private defaultHeaders: Record<string, string>;
+  private defaultTimeout: number;
+  private proxyAgent?: ProxyAgent;
+
+  constructor(baseUrl: string, options?: HttpClientOptions) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.defaultHeaders = options?.defaultHeaders || {};
+    this.defaultTimeout = options?.defaultTimeout || 30000;
+
+    // 初始化代理 agent，使用统一的代理配置获取逻辑
+    const proxyUrl = getProxyUrl(options?.proxy);
+
+    if (proxyUrl) {
+      this.proxyAgent = new ProxyAgent(proxyUrl);
+    }
+  }
+
+  /**
+   * 执行 HTTP 请求
+   */
+  async request<T = unknown>(
+    config: HttpRequestConfig
+  ): Promise<HttpResponse<T>> {
+    const {
+      method = "GET",
+      headers = {},
+      body,
+      timeout = this.defaultTimeout,
+      query,
+    } = config;
+
+    // 构建 URL
+    let url = config.url;
+    if (!url.startsWith("http://") && !url.startsWith("https://")) {
+      url = `${this.baseUrl}${url.startsWith("/") ? "" : "/"}${url}`;
+    }
+
+    // 添加查询参数
+    if (query && Object.keys(query).length > 0) {
+      const params = new URLSearchParams();
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== undefined) {
+          params.append(key, String(value));
+        }
+      });
+      const queryString = params.toString();
+      if (queryString) {
+        url += (url.includes("?") ? "&" : "?") + queryString;
+      }
+    }
+
+    // 合并请求头
+    const mergedHeaders: Record<string, string> = {
+      ...this.defaultHeaders,
+      ...headers,
+    };
+
+    // 设置 Content-Type
+    if (body && !mergedHeaders["Content-Type"]) {
+      mergedHeaders["Content-Type"] = "application/json";
+    }
+
+    // 准备请求体
+    let requestBody: string | undefined;
+    if (body !== null && body !== undefined) {
+      if (typeof body === "string") {
+        requestBody = body;
+      } else {
+        requestBody = JSON.stringify(body);
+      }
+    }
+
+    try {
+      const dispatcher: Dispatcher = shouldUseProxy(
+        getProxyUrl(),
+        config.disableProxy
+      ) && this.proxyAgent
+        ? this.proxyAgent
+        : undefined;
+
+      const response = await request(url, {
+        method,
+        headers: mergedHeaders as HeadersInit,
+        body: requestBody,
+        headersTimeout: timeout,
+        bodyTimeout: timeout,
+        dispatcher,
+      });
+
+      // 读取响应体
+      const responseBody = await response.body.text();
+      let data: T;
+
+      try {
+        data = responseBody ? JSON.parse(responseBody) : ({} as T);
+      } catch {
+        data = responseBody as unknown as T;
+      }
+
+      // 检查响应状态
+      if (response.statusCode >= 200 && response.statusCode < 300) {
+        return {
+          data,
+          status: response.statusCode,
+          headers: response.headers as Record<
+            string,
+            string | string[] | undefined
+          >,
+        };
+      } else {
+        throw new HttpError(
+          response.statusCode,
+          data,
+          `HTTP request failed with status ${response.statusCode}`
+        );
+      }
+    } catch (error) {
+      if (error instanceof HttpError) {
+        throw error;
+      }
+      throw new Error(
+        `HTTP request failed: ${
+          error instanceof Error ? error.message : String(error)
+        }`
+      );
+    }
+  }
+
+  /**
+   * GET 请求
+   */
+  async get<T = unknown>(
+    url: string,
+    config?: Omit<HttpRequestConfig, "url" | "method">
+  ): Promise<HttpResponse<T>> {
+    return this.request<T>({ ...config, url, method: "GET" });
+  }
+
+  /**
+   * POST 请求
+   */
+  async post<T = unknown>(
+    url: string,
+    config?: Omit<HttpRequestConfig, "url" | "method">
+  ): Promise<HttpResponse<T>> {
+    return this.request<T>({ ...config, url, method: "POST" });
+  }
+
+  /**
+   * PUT 请求
+   */
+  async put<T = unknown>(
+    url: string,
+    config?: Omit<HttpRequestConfig, "url" | "method">
+  ): Promise<HttpResponse<T>> {
+    return this.request<T>({ ...config, url, method: "PUT" });
+  }
+
+  /**
+   * DELETE 请求
+   */
+  async delete<T = unknown>(
+    url: string,
+    config?: Omit<HttpRequestConfig, "url" | "method">
+  ): Promise<HttpResponse<T>> {
+    return this.request<T>({ ...config, url, method: "DELETE" });
+  }
+
+  /**
+   * PATCH 请求
+   */
+  async patch<T = unknown>(
+    url: string,
+    config?: Omit<HttpRequestConfig, "url" | "method">
+  ): Promise<HttpResponse<T>> {
+    return this.request<T>({ ...config, url, method: "PATCH" });
+  }
+}

package/src/apis/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Claw Cloud API 模块
+ */
+export { createClawCloudClient, ClawCloudClient } from './claw-cloud.js';
+export { HttpClient, HttpError, type HttpRequestConfig, type HttpResponse } from './http-client.js';
+export { createHonorAuthClient, HonorAuthClient } from './honor-auth.js';
+export * from './types.js';
+export * from './helpers.js';

package/src/apis/types.ts

@@ -0,0 +1,47 @@
+/**
+ * 设备注册接口相关类型定义
+ */
+import type { ClawDeviceInfo, DeviceInfo, DeviceRole } from "../types.js";
+
+/**
+ * 设备注册请求体
+ */
+export interface DeviceRegistryRequest {
+  businessTag: "YOYO_CLAW";
+  role: DeviceRole;
+  deviceInfo: Omit<ClawDeviceInfo, "role">;
+}
+
+export interface HttpApiWrapper<T = any> {
+  code: string;
+  success: boolean;
+  cnMessage: string;
+  data?: T;
+}
+
+/**
+ * 设备注册响应体
+ */
+export type DeviceRegistryResponse = HttpApiWrapper;
+
+/**
+ * 设备注册请求头
+ */
+export interface DeviceRegistryHeaders {
+  "x-trace-id": string;
+  "x-udid": string;
+  /**
+   * token信息
+   */
+  "x-jwt-token"?: string;
+  /**
+   * 用户id加密后的信息
+   */
+  authorization?: string;
+  /**
+   * 端用，claw侧不需要
+   */
+  // authorization?: string;
+  // debug mode
+  "x-agw-userId"?: string;
+}