← 返回 Skills 市场

我家云工单

Name: 我家云工单
Author: mumuxilele

作者 mumuxilele · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ pending

总下载

当前安装

版本数

在 OpenClaw 中安装

/install wojiayun

功能描述

提供我家云设备管理与工单系统接口，支持设备查询、维修、巡检、维保及多项目工单统计与管理。

使用说明 (SKILL.md)

Wojiayun Skill

基本信息

名称: wojiayun_skill
版本: 1.0.0
描述: 我家云设备管理与工单系统技能包
作者: SOLO
创建时间: 2026-05-22

认证方式

本技能仅支持 API Key 认证，不支持用户名/密码登录。

使用前必须提供 API Key，通过以下方式设置：

from wojiayun_skill import store_api_key
store_api_key("your_api_key_here")

如果没有 API Key，请联系我家云平台管理员获取。

重要规则

项目切换规则

部分接口只能查询当前项目的数据，如需查询多个项目：

先缓存已查询的项目工单
调用切换项目接口
再查询新项目数据
最后按项目维度汇总统计

只能查当前项目的接口

get_equipment_repairs - 设备维修工单
get_equipments - 设备列表
get_equip_ins_list - 设备巡检任务
get_device_maintain_list - 设备维保任务

可跨项目查询的接口

query_workorders - 工单统计（支持多项目ID参数）
get_my_workorders - 工单列表（action=1 可查全部）

API 接口列表

用户认证

接口名	路径	方法	说明
`token_refresh`	/thirdUser/apiKeyAuth	GET	API Key换取Token
`get_current_user_info`	/users/getCurrentUserInfo	GET	获取当前用户信息
`get_projects`	/projects/getProjectsByUserIDAndName	GET	获取项目列表
`set_default_project`	/employees/setDefaultProject	GET	切换项目

设备管理

接口名	路径	方法	说明
`get_equipments`	/equipments/getAllEquipMents	GET	获取设备列表（当前项目）
`get_equipment_detail`	/equipments/getEquipMentDetail	GET	获取设备详情

设备巡检

接口名	路径	方法	说明
`get_equip_ins_list`	/equipIns/selectAllEquipInsEntryList	GET	获取巡检任务（当前项目）

设备维保

接口名	路径	方法	说明
`get_device_maintain_list`	/equMaiPlanEntrys/getDeviceViewList	GET	获取维保任务（当前项目）

设备维修

接口名	路径	方法	说明
`get_equipment_repairs`	/equMaintenance/pageEquMaintenanceList	GET	获取维修工单（当前项目）

维修状态码：

状态码	说明
0	待分派
1	待处理
2	处理中
3	已完成
4	已归档

维保周期映射：

代码	含义
month	每月
double_month	双月
quarter	每季
half_year	半年
year	每年
define	自定义
many_month	每月多次

工单管理

接口名	路径	方法	说明
`get_work_type`	/workorders/getWorkType	GET	获取工单类型
`search_rooms`	/rooms/getRoomsByBuildInfoV3	GET	搜索房间
`get_room_customers`	/workorders/getAllCustomerByRoomId	GET	获取房间客户
`create_workorder`	/workorders/insertWorkorder	POST	创建工单
`get_pending_workorders`	/workCustomer/getWoprocessPagingList	POST	待我处理工单
`get_my_workorders`	/workorders/getAllWorkorder	GET	工单列表
`query_workorders`	/workCustomer/getWoprocessPagingList	POST	工单统计（支持多项目）

工单查询参数：

action=0: 待我受理分派（当前用户）
action=1: 所有待受理工单（全部）

工单统计参数：

{
  "action": "queryList",
  "projectID": "项目ID1,项目ID2,...",
  "projectIDs": "项目ID1,项目ID2,...",
  "projectName": "项目名等N个项目",
  "createTime": "ownDefined",
  "definedTime_list1": "2026-05-01~2026-05-23"
}

公区管理

接口名	路径	方法	说明
`get_public_area_paging`	/publicArea/getPublicAreaPaging	GET	搜索公区

文件管理

接口名	路径	方法	说明
`upload_files`	/api/file/uploadFiles	POST	上传文件（视频最大20MB）

使用方式

from wojiayun_skill import SecureAPIClient, store_api_key

# 1. 设置 API Key（必须）
store_api_key("your_api_key_here")

# 2. 创建客户端
client = SecureAPIClient()

# 3. 获取设备列表
result = client.call_api("get_equipments", "GET")

# 4. 查询工单统计（多项目）
result = client.call_api("query_workorders", "POST", data={
    "current": 1,
    "rowCount": 500,
    "queryParams": {
        "action": "queryList",
        "projectID": "项目ID1,项目ID2",
        "createTime": "ownDefined",
        "definedTime_list1": "2026-05-01~2026-05-23"
    }
})

安全特性

加密: AES-256-GCM
模式: 生产模式
白名单控制: 只允许调用授权接口
敏感信息加密: URL、Token 均加密存储
静默模式: 不输出敏感信息

依赖安装

pip install requests cryptography

注意事项

必须提供有效的 API Key 才能使用
不支持用户名/密码登录
所有敏感配置信息均已加密存储
设备维修/巡检/维保工单只能查当前项目，多项目需切换后汇总

能力标签

requires-oauth-tokenrequires-sensitive-credentials

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install wojiayun
安装完成后，直接呼叫该 Skill 的名称或使用 /wojiayun 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Wojiayun Skill 1.0.0 初始版本发布： - 提供我家云设备管理与工单系统接口能力，覆盖设备列表、维修、维保、巡检等核心功能。 - 支持通过 API Key 认证方式，用户名/密码登录不支持。 - 明确区分只能查当前项目与可跨项目查询的接口，内置项目切换与多项目汇总规则说明。 - 提供详细 API 接口列表与参数范例，方便集成调用。 - 内置安全特性，包括 AES-256-GCM 加密、白名单控制与敏感信息加密存储。 - 附带依赖安装与使用示例代码。

元数据

Slug wojiayun

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题