@sav7ng/cloudphone 0.0.1

package/README.md

@@ -0,0 +1,237 @@
+## CloudPhone Plugin
+
+OpenClaw CloudPhone 插件，用于为 Agent 提供 **CloudPhone 设备连接链路查询** 等自定义工具能力。
+
+当前实现的主要功能：
+
+- **调试工具 `echo`**：回显输入内容，验证插件和工具调用链路是否正常
+- **设备连接链路查询 `get_device_connection_link`**：根据设备 ID 查询 SSH 连接命令、密码以及过期时间
+
+---
+
+### 目录结构
+
+```
+cloudphone/
+├── openclaw.plugin.json   # 插件清单（id、configSchema、uiHints）
+├── package.json           # npm 依赖 & 构建脚本
+├── tsconfig.json          # TypeScript 编译配置
+├── src/
+│   ├── index.ts           # 插件入口，注册所有工具
+│   └── tools.ts           # Agent 工具定义与实现
+└── README.md
+```
+
+---
+
+### 开发与构建
+
+- **安装依赖**
+
+```bash
+npm install
+```
+
+- **开发模式（监听编译）**
+
+```bash
+npm run dev
+```
+
+- **生产构建**
+
+```bash
+npm run build
+```
+
+构建产物默认为 `dist/index.js`，并通过 `package.json` 中的 `openclaw.extensions` 暴露给 OpenClaw。
+
+---
+
+### 在 OpenClaw 中加载插件
+
+- **方式一：链接模式（开发推荐）**
+
+```bash
+openclaw plugins install -l ./
+```
+
+- **方式二：扩展目录**
+
+将整个目录复制（或软链接）到工作区：
+
+```text
+<workspace>/.openclaw/extensions/cloudphone/
+```
+
+或全局目录：
+
+```text
+~/.openclaw/extensions/cloudphone/
+```
+
+- **方式三：配置路径**
+
+在 OpenClaw 配置中添加（指向构建后的入口文件）：
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["E:/cloudphone/dist/index.js"]
+    }
+  }
+}
+```
+
+---
+
+### 插件配置（`openclaw.plugin.json`）
+
+插件配置位于 OpenClaw 配置的 `plugins.entries.cloudphone.config` 下，对应的 `configSchema` 为：
+
+- `baseUrl`：CloudPhone API 基础地址，默认 `https://cptest.yaltc.cn`
+- `token`：Bearer Token 鉴权凭证
+- `timeout`：请求超时时间（毫秒），默认 `5000`
+
+示例配置：
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "cloudphone": {
+        "enabled": true,
+        "config": {
+          "baseUrl": "https://cptest.yaltc.cn",
+          "token": "your-bearer-token",
+          "timeout": 5000
+        }
+      }
+    }
+  }
+}
+```
+
+| 字段       | 类型   | 必填 | 说明                                   |
+|------------|--------|------|----------------------------------------|
+| `baseUrl`  | string | 否   | CloudPhone API 基础地址，未配置时使用默认值   |
+| `token`    | string | 否   | Bearer Token，用于访问受保护接口       |
+| `timeout`  | number | 否   | 请求超时（ms），默认 `5000`           |
+
+> 修改配置后通常需要重启 Gateway 才能生效。
+
+---
+
+### 已注册工具
+
+所有工具都在 `src/tools.ts` 中定义，并在 `src/index.ts` 中通过 `api.registerTool` 注册。
+
+| 工具名                            | 说明                                             |
+|-----------------------------------|--------------------------------------------------|
+| `echo`                        | 回显输入文本，用于验证工具调用是否正常          |
+| `get_device_connection_link`  | 查询指定设备的 SSH 连接链路及过期时间           |
+
+#### `echo`
+
+- **用途**：调试用工具，确保 OpenClaw 已正确加载插件并能成功调用工具。
+- **请求参数**：
+
+```json
+{
+  "text": "hello"
+}
+```
+
+- **返回示例**：
+
+```json
+{
+  "echo": "hello"
+}
+```
+
+#### `get_device_connection_link`
+
+- **用途**：根据设备 ID 查询 SSH 连接链路信息。
+- **后端 API**：
+  - `GET {baseUrl}/webide/api/autojs-stream/device-connection-link/{deviceId}`
+  - 鉴权：可选 `Authorization: Bearer <token>`
+- **请求参数**：
+
+```json
+{
+  "deviceId": "7593283098889067310"
+}
+```
+
+- **成功返回示例（简化）**：
+
+```json
+{
+  "ok": true,
+  "deviceId": "7593283098889067310",
+  "sshCommand": "ssh root@host -p 12345",
+  "macSshCommand": "ssh root@host -p 12345",
+  "sshPwd": "password",
+  "expireTime": 1730000000,
+  "expireAt": "2024-10-27T10:00:00.000Z",
+  "traceId": "xxxx"
+}
+```
+
+- **失败返回示例（简化）**：
+
+```json
+{
+  "ok": false,
+  "code": "xxx",
+  "message": "错误信息",
+  "traceId": "xxxx"
+}
+```
+
+工具内部会根据配置自动：
+
+- 选择 `baseUrl`（默认 `https://cptest.yaltc.cn`）
+- 在配置了 `token` 时附带 `Authorization` 头
+- 根据 `timeout` 做超时控制，并返回明确的错误信息
+
+---
+
+### 扩展：添加新工具
+
+1. 在 `src/tools.ts` 中新增一个符合 `ToolDefinition` 接口的对象：
+
+```typescript
+const myTool: ToolDefinition = {
+  name: "my_tool",          // 建议使用 snake_case
+  description: "工具功能描述",
+  parameters: {
+    type: "object",
+    properties: {
+      input: { type: "string", description: "输入参数" }
+    },
+    required: ["input"]
+  },
+  handler: async ({ input }, config) => {
+    // 使用 config.baseUrl / config.token / config.timeout 实现业务逻辑
+    return { result: input };
+  }
+};
+```
+
+2. 将新工具加入导出的 `tools` 数组：
+
+```typescript
+export const tools: ToolDefinition[] = [echoTool, getDeviceConnectionLinkTool, myTool];
+```
+
+3. 运行构建并重启 Gateway：
+
+```bash
+npm run build
+```
+
+> 重启后，OpenClaw 会自动根据插件导出的工具列表更新 Agent 可用工具。
+

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import { CloudphonePluginConfig, McpToolResult } from "./tools";
+/**
+ * OpenClaw 插件 API 简化类型声明。
+ * 完整类型由 OpenClaw 运行时在加载时注入，此处仅声明插件用到的部分。
+ */
+interface PluginApi {
+    logger: {
+        info: (msg: string, ...args: unknown[]) => void;
+        warn: (msg: string, ...args: unknown[]) => void;
+        error: (msg: string, ...args: unknown[]) => void;
+    };
+    config: {
+        plugins?: {
+            entries?: Record<string, {
+                config?: CloudphonePluginConfig;
+            }>;
+        };
+    };
+    registerTool: (tool: {
+        name: string;
+        description: string;
+        parameters: unknown;
+        execute: (id: string, params: Record<string, unknown>) => Promise<McpToolResult>;
+    }) => void;
+}
+declare const plugin: {
+    id: string;
+    configSchema: {
+        type: string;
+        additionalProperties: boolean;
+        properties: {
+            baseUrl: {
+                type: string;
+            };
+            token: {
+                type: string;
+            };
+            timeout: {
+                type: string;
+            };
+        };
+    };
+    register(api: PluginApi): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,sBAAsB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvE;;;GAGG;AACH,UAAU,SAAS;IACjB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAChD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAChD,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;KAClD,CAAC;IACF,MAAM,EAAE;QACN,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;gBAAE,MAAM,CAAC,EAAE,sBAAsB,CAAA;aAAE,CAAC,CAAC;SAC/D,CAAC;KACH,CAAC;IACF,YAAY,EAAE,CAAC,IAAI,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;KAClF,KAAK,IAAI,CAAC;CACZ;AASD,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;kBAaI,SAAS;CAuDxB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tools_1 = require("./tools");
+/**
+ * 从 OpenClaw 运行时配置中读取当前插件的配置项。
+ */
+function resolveConfig(api) {
+    return api.config?.plugins?.entries?.["cloudphone"]?.config ?? {};
+}
+const plugin = {
+    id: "cloudphone",
+    configSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            baseUrl: { type: "string" },
+            token: { type: "string" },
+            timeout: { type: "number" },
+        },
+    },
+    register(api) {
+        const config = resolveConfig(api);
+        api.logger.info(`[cloudphone] 加载完成，baseUrl=${config.baseUrl ?? "(未配置，使用默认值)"}`);
+        for (const tool of tools_1.tools) {
+            api.registerTool({
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+                execute: async (id, params) => {
+                    api.logger.info(`[cloudphone] 工具 ${tool.name} 开始执行，id=${id}，params=${JSON.stringify(params)}`);
+                    try {
+                        const result = await tool.execute(id, params, config);
+                        api.logger.info(`[cloudphone] 工具 ${tool.name} 返回值: ${JSON.stringify(result)}`);
+                        if (result &&
+                            Array.isArray(result.content) &&
+                            result.content.length > 0) {
+                            return result;
+                        }
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: result
+                                        ? JSON.stringify(result)
+                                        : `[cloudphone] 工具 ${tool.name} 未返回有效内容`,
+                                },
+                            ],
+                        };
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        api.logger.error(`[cloudphone] 工具 ${tool.name} 执行异常: ${message}`);
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({ ok: false, error: message }),
+                                },
+                            ],
+                        };
+                    }
+                },
+            });
+            api.logger.info(`[cloudphone] 已注册工具: ${tool.name}`);
+        }
+    },
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,mCAAuE;AAyBvE;;GAEG;AACH,SAAS,aAAa,CAAC,GAAc;IACnC,OAAO,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,YAAY;IAEhB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC5B;KACF;IAED,QAAQ,CAAC,GAAc;QACrB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC,CAAC;QAEhF,KAAK,MAAM,IAAI,IAAI,aAAK,EAAE,CAAC;YACzB,GAAG,CAAC,YAAY,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;oBAC5B,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,mBAAmB,IAAI,CAAC,IAAI,YAAY,EAAE,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC9E,CAAC;oBACF,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;wBACtD,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,mBAAmB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC9D,CAAC;wBACF,IACE,MAAM;4BACN,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;4BAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EACzB,CAAC;4BACD,OAAO,MAAM,CAAC;wBAChB,CAAC;wBACD,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAe;oCACrB,IAAI,EAAE,MAAM;wCACV,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;wCACxB,CAAC,CAAC,mBAAmB,IAAI,CAAC,IAAI,UAAU;iCAC3C;6BACF;yBACF,CAAC;oBACJ,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBACnD,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,mBAAmB,IAAI,CAAC,IAAI,UAAU,OAAO,EAAE,CAChD,CAAC;wBACF,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAe;oCACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;iCACpD;6BACF;yBACF,CAAC;oBACJ,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,kBAAe,MAAM,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Agent 工具定义模块
+ *
+ * 每个工具需包含：
+ *   - name:        snake_case 格式的工具名
+ *   - description: 向 AI Agent 说明工具用途
+ *   - parameters:  JSON Schema 描述入参结构
+ *   - execute:     执行函数，接收 (id, params)，返回 MCP Content 格式结果
+ *
+ * 官方文档：https://docs.openclaw.ai/plugins/agent-tools
+ */
+/** 插件配置类型（与 openclaw.plugin.json configSchema 保持一致） */
+export interface CloudphonePluginConfig {
+    baseUrl?: string;
+    token?: string;
+    timeout?: number;
+}
+/** MCP Content 项 */
+export interface McpContentItem {
+    type: "text";
+    text: string;
+}
+/** MCP 风格的工具返回值 */
+export interface McpToolResult {
+    content: McpContentItem[];
+}
+/** 工具定义类型（与 OpenClaw api.registerTool 参数对齐） */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    execute: (id: string, params: Record<string, unknown>, config: CloudphonePluginConfig) => Promise<McpToolResult>;
+}
+/** 导出所有工具定义列表 */
+export declare const tools: ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mBAAmB;AACnB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,sBAAsB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAClH;AAiID,iBAAiB;AACjB,eAAO,MAAM,KAAK,EAAE,cAAc,EAA4C,CAAC"}

package/dist/tools.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Agent 工具定义模块
+ *
+ * 每个工具需包含：
+ *   - name:        snake_case 格式的工具名
+ *   - description: 向 AI Agent 说明工具用途
+ *   - parameters:  JSON Schema 描述入参结构
+ *   - execute:     执行函数，接收 (id, params)，返回 MCP Content 格式结果
+ *
+ * 官方文档：https://docs.openclaw.ai/plugins/agent-tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tools = void 0;
+/**
+ * 调试工具：echo
+ * 原样返回输入内容，用于验证工具调用链路是否正常。
+ */
+const echoTool = {
+    name: "echo",
+    description: "将输入的文本原样返回，用于验证工具调用是否正常。",
+    parameters: {
+        type: "object",
+        properties: {
+            text: {
+                type: "string",
+                description: "需要回显的文本内容",
+            },
+        },
+        required: ["text"],
+    },
+    execute: async (_id, { text }) => {
+        return { content: [{ type: "text", text: String(text) }] };
+    },
+};
+/**
+ * 工具：get_device_connection_link
+ * 查询指定设备的 SSH 连接链路信息。
+ *
+ * API: GET {baseUrl}/webide/api/autojs-stream/device-connection-link/{deviceId}
+ * Auth: Bearer Token
+ */
+const getDeviceConnectionLinkTool = {
+    name: "get_device_connection_link",
+    description: "查询指定设备的 SSH 连接链路信息，返回 SSH 连接地址（host:port）和链路过期时间。需要提供设备 ID。",
+    parameters: {
+        type: "object",
+        properties: {
+            deviceId: {
+                type: "string",
+                description: "设备 ID，如 7593283098889067310",
+            },
+        },
+        required: ["deviceId"],
+    },
+    execute: async (_id, { deviceId }, config) => {
+        const base = config.baseUrl ?? "https://cptest.yaltc.cn";
+        const timeout = config.timeout ?? 5000;
+        const url = `${base}/webide/api/autojs-stream/device-connection-link/${String(deviceId)}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (config.token) {
+            headers["Authorization"] = `Bearer ${config.token}`;
+        }
+        let timer;
+        let body;
+        try {
+            const controller = typeof AbortController !== "undefined" ? new AbortController() : undefined;
+            if (controller) {
+                timer = setTimeout(() => controller.abort(), timeout);
+            }
+            const res = await fetch(url, {
+                method: "GET",
+                headers,
+                signal: controller?.signal,
+            });
+            if (!res.ok) {
+                const result = { ok: false, httpStatus: res.status, message: `HTTP 错误：${res.status} ${res.statusText}` };
+                return { content: [{ type: "text", text: JSON.stringify(result) }] };
+            }
+            body = (await res.json());
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const result = { ok: false, message: `请求失败：${message}` };
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
+        if (!body.success || body.code !== "1") {
+            const result = { ok: false, code: body.code, message: body.message, traceId: body.traceId };
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        const data = body.data;
+        if (!data) {
+            const result = { ok: false, message: "API 返回数据为空", traceId: body.traceId };
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        const result = {
+            ok: true,
+            deviceId: data.deviceId,
+            sshCommand: data.sshCommand,
+            macSshCommand: data.macSshCommand,
+            sshPwd: data.sshPwd,
+            expireTime: data.expireTime,
+            expireAt: new Date(data.expireTime * 1000).toISOString(),
+            traceId: body.traceId,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+};
+/** 导出所有工具定义列表 */
+exports.tools = [echoTool, getDeviceConnectionLinkTool];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -0,0 +1,40 @@
+{
+  "id": "cloudphone",
+  "name": "CloudPhone Plugin",
+  "version": "1.0.0",
+  "description": "OpenClaw CloudPhone 插件 —— 提供设备连接链路查询等 Agent 工具能力",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "baseUrl": {
+        "type": "string",
+        "description": "CloudPhone API 基础地址",
+        "default": "https://cptest.yaltc.cn"
+      },
+      "token": {
+        "type": "string",
+        "description": "Bearer Token 鉴权凭证"
+      },
+      "timeout": {
+        "type": "number",
+        "description": "请求超时时间（毫秒）",
+        "default": 5000
+      }
+    }
+  },
+  "uiHints": {
+    "baseUrl": {
+      "label": "API 基础地址",
+      "placeholder": "https://cptest.yaltc.cn"
+    },
+    "token": {
+      "label": "Bearer Token",
+      "placeholder": "输入鉴权 Token",
+      "sensitive": true
+    },
+    "timeout": {
+      "label": "请求超时（ms）"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@sav7ng/cloudphone",
+  "version": "0.0.1",
+  "description": "OpenClaw CloudPhone 插件 —— 提供自定义 Agent 工具能力",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "cloudphone"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "rimraf": "^5.0.0"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  }
+}