OpenClaw与Windchill实战:查询用户&新建文件夹

    此前已在Windows本地完成OpenClaw部署：

Windows本地部署OpenClaw详细教程

    部署完成后，怀着满心期待打算用OpenClaw新建“Windchill用户”小试牛刀，看看实际操作效果，结果却遭遇挫败——新建用户失败！作为代码小白，此刻只想大喊995求助：

995：用OpenClaw创建Windchill用户失败了，求助！

    好在没有轻言放弃，随后找到了Windchill 11.0的API文档，决定让OpenClaw系统学习API文档知识，继续探索前行，不负每一次尝试。

    想要让OpenClaw顺利操作Windchill，前提是让它吃透Windchill API文档，为此整理了针对性的脚本，助力OpenClaw高效学习。

• 让OpenClaw学习Windchill API文档
  
• 脚本示例
  # Windchill REST API 文档爬取$baseUrl = "https://pdmtest.xxx.com:8080/Windchill"$username = "zhouxxx"$password = "xxx"# 编码凭证$cred = "${username}:${password}"$bytes = [System.Text.Encoding]::UTF8.GetBytes($cred)$base64 = [Convert]::ToBase64String($bytes)# 主要的 REST API 文档页面$mainUrl = "$baseUrl/netmarkets/jsp/restapi/index.html"Write-Host"=== Windchill REST API 文档 ==="Write-Host"URL: $mainUrl"Write-Host""# 先获取主页面try {Write-Host"获取主页面..."$response = Invoke-WebRequest-Uri$mainUrl-Method Get -Headers@{"Accept" = "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8""Authorization" = "Basic $base64"    } -UseBasicParsing-TimeoutSec30Write-Host"状态: $($response.StatusCode)"Write-Host"内容类型: $($response.Headers['Content-Type'])"Write-Host""Write-Host"========== 主页面内容 =========="Write-Host$response.ContentWrite-Host"========== 页面内容结束 =========="} catch {Write-Host"❌ 获取主页面失败: $($_.Exception.Message)"}Write-Host""Write-Host"=== 爬取完成 ==="

• 太好了！这是 Windchill 的 Swagger UI API 文档页面。继续

  # 获取 Windchill REST API 的 Swagger 定义$baseUrl = "https://pdmtest.xxx.com:8080/Windchill"$username = "zhouxxx"$password = "xxx"# 编码凭证$cred = "${username}:${password}"$bytes = [System.Text.Encoding]::UTF8.GetBytes($cred)$base64 = [Convert]::ToBase64String($bytes)# Swagger JSON 端点$swaggerUrl = "$baseUrl/servlet/rest/swagger.json"Write-Host"=== 获取 Swagger API 定义 ==="Write-Host"URL: $swaggerUrl"Write-Host""try {$response = Invoke-WebRequest-Uri$swaggerUrl-Method Get -Headers@{"Accept" = "application/json""Authorization" = "Basic $base64"    } -UseBasicParsing-TimeoutSec60Write-Host"状态: $($response.StatusCode)"Write-Host"内容类型: $($response.Headers['Content-Type'])"Write-Host"内容长度: $($response.Content.Length)"Write-Host""# 保存到文件$savePath = "$env:USERPROFILE\Desktop\Windchill_Swagger_API.json"$response.Content | Out-File-FilePath$savePath-Encoding UTF8Write-Host"✅ 已保存到: $savePath"Write-Host""# 解析并显示关键信息$swagger = $response.Content | ConvertFrom-JsonWrite-Host"========== API 信息 =========="Write-Host"标题: $($swagger.info.title)"Write-Host"版本: $($swagger.info.version)"Write-Host"描述: $($swagger.info.description)"Write-Host""# 显示所有路径Write-Host"========== 可用的 API 路径 =========="$swagger.paths | Get-Member-MemberType NoteProperty | ForEach-Object {$path = $_.NameWrite-Host"路径: $path"$pathMethods = $swagger.paths.$path | Get-Member-MemberType NotePropertyforeach ($methodin$pathMethods) {$methodName = $method.Name$operation = $swagger.paths.$path.$methodName$summary = if ($operation.summary) { $operation.summary } else { "N/A" }Write-Host"  - $methodName : $summary"        }Write-Host""    }Write-Host"========== Definitions (数据类型定义) =========="if ($swagger.definitions) {$swagger.definitions | Get-Member-MemberType NoteProperty | Select-Object-First20 | ForEach-Object {Write-Host"定义: $($_.Name)"        }Write-Host"... (更多定义请查看保存的 JSON 文件)"    }} catch {Write-Host"❌ 获取失败: $($_.Exception.Message)"}

• 重要发现【CSRF Token 点:/Securit/csrf -GET: Geta CSRF noncekey and value】

  

    经过系统学习API资料，梳理出常用API端点、功能及可测试状态，为后续操作提供清晰指引，具体如下：

    新建用户失败后，没有停滞不前，而是继续尝试，调用“查询用户”脚本，逐步突破。

• 在此前继续新建用户的尝试过程中，调用了“查询用户”脚本
  
  $cred = "wcadmin:xxx"$bytes = [System.Text.Encoding]::UTF8.GetBytes($cred)$base64 = [Convert]::ToBase64String($bytes)$usersUrl = "http://pdmtest.xxx.com/Windchill/servlet/odata/v2/PrincipalMgmt/Users"try {Write-Host"测试 GET 请求到: $usersUrl"$response = Invoke-WebRequest-Uri$usersUrl-Method Get -Headers@{"Accept" = "application/json""Authorization" = "Basic $base64"    } -UseBasicParsingWrite-Host"✅ GET 请求成功! 状态码: $($response.StatusCode)"Write-Host"响应内容:"Write-Host$response.Content} catch {Write-Host"❌ GET 请求失败!"Write-Host"状态码: $($_.Exception.Response.StatusCode.value__)"Write-Host"错误: $($_.Exception.Message)"}

• 返回结果【太好了！GET 请求成功了】
  
  {"ID":"OR:wt.org.WTUser:2066223","Identity":"OpenClawTest","Name":"OpenClawTest","DistinguishedName":"...","Status":null,"CreatedOn":"2026-03-08T10:55:25Z","LastModified":"2026-04-15T13:10:00Z","LastName":"OpenClawTest","FullName":"OpenClawTest","EMail":"test@test.com",// ... 更多字段}

    在查询用户成功的基础上，继续挑战创建文件夹功能，过程中虽遭遇报错，但通过不断调试，最终实现突破。

• 脚本示例：
  # Windchill REST API - 创建文件夹$baseUrl = "http://pdmtest.xxx.com/Windchill"$username = "wcadmin"$password = "xxx"# 编码凭证$pair = "$username`:$password"$bytes = [System.Text.Encoding]::ASCII.GetBytes($pair)$base64 = [System.Convert]::ToBase64String($bytes)Write-Host"=== Windchill 创建文件夹测试 ==="Write-Host""# 步骤1: 获取 CSRF TokenWrite-Host"步骤1: 获取 CSRF Token..."$csrfUrl = "$baseUrl/servlet/rest/security/csrf"$csrfResp = Invoke-WebRequest-Uri$csrfUrl-Method Get -Headers@{"Accept" = "application/json""Authorization" = "Basic $base64"} -UseBasicParsing-SessionVariable wcSession$csrfData = $csrfResp.Content | ConvertFrom-Json$csrfToken = $csrfData.items[0].attributes.nonceWrite-Host"✅ CSRF Token: $($csrfToken.Substring(0,30))..."Write-Host""# 步骤2: 先查看现有的上下文和文件夹结构Write-Host"步骤2: 查看现有的上下文..."$contextsUrl = "$baseUrl/servlet/rest/v1/contexts"try {$contextsResp = Invoke-WebRequest-Uri$contextsUrl-Method Get -Headers@{"Accept" = "application/json""Authorization" = "Basic $base64"    } -UseBasicParsing$contexts = $contextsResp.Content | ConvertFrom-JsonWrite-Host"上下文数量: $($contexts.items.Count)"if ($contexts.items.Count -gt0) {Write-Host"第一个上下文:"$contexts.items[0] | ConvertTo-Json-Depth3 | Write-Host    }} catch {Write-Host"❌ 获取上下文失败: $($_.Exception.Message)"}Write-Host""# 步骤3: 查看现有的文件夹Write-Host"步骤3: 查看根文件夹..."$foldersUrl = "$baseUrl/servlet/rest/v1/folders"try {$foldersResp = Invoke-WebRequest-Uri$foldersUrl-Method Get -Headers@{"Accept" = "application/json""Authorization" = "Basic $base64"    } -UseBasicParsing$folders = $foldersResp.Content | ConvertFrom-JsonWrite-Host"根文件夹数量: $($folders.items.Count)"if ($folders.items.Count -gt0) {Write-Host"文件夹列表:"$folders.items | ForEach-Object {Write-Host"  - $($_.id): $($_.name)"        }    }} catch {Write-Host"❌ 获取文件夹失败: $($_.Exception.Message)"}Write-Host""# 步骤4: 创建新文件夹Write-Host"步骤4: 创建新文件夹..."# 文件夹数据 - 需要指定在哪个上下文/文件夹下创建$folderData = @{"name" = "TestAPIFolder""description" = "通过 REST API 创建的测试文件夹""containerPath" = "/wt.inf.container.OrgContainer=xxx"# 根据实际情况调整} | ConvertTo-JsonWrite-Host"请求数据: $folderData"Write-Host""try {$createResp = Invoke-WebRequest-Uri$foldersUrl-Method Post -Headers@{"Accept" = "application/json""Content-Type" = "application/json""Authorization" = "Basic $base64""CSRF_NONCE" = $csrfToken    } -Body$folderData-UseBasicParsingWrite-Host"✅ 创建成功! 状态: $($createResp.StatusCode)"Write-Host"响应:"Write-Host$createResp.Content} catch {Write-Host"❌ 创建失败: $($_.Exception.Response.StatusCode.value__)"if ($_.Exception.Response -ne$null) {try {$stream = $_.Exception.Response.GetResponseStream()$stream.Position = 0$reader = New-Object System.IO.StreamReader($stream)$errorBody = $reader.ReadToEnd()$reader.Close()$stream.Close()Write-Host"错误详情: $errorBody"        } catch {Write-Host"读取错误详情失败: $_"        }    }}Write-Host""Write-Host"=== 测试完成 ==="

• 调试报错【错误提示：Unrecognized field "containerPath" - 说明字段名不对】
  
• 继续调试，报错【FolderInfo 正确字段】
  
• 这一次终于成功了【🎉 太棒了！文件夹创建成功！】
  
  脚本示例：
  # Windchill REST API - 创建文件夹（正确字段）$baseUrl = "http://pdmtest.xxx.com/Windchill"$username = "wcadmin"$password = "xxx"$pair = "$username`:$password"$bytes = [System.Text.Encoding]::ASCII.GetBytes($pair)$base64 = [System.Convert]::ToBase64String($bytes)Write-Host"=== Windchill 创建文件夹（正确字段）==="# 获取 CSRF Token$csrfResp = Invoke-WebRequest-Uri"$baseUrl/servlet/rest/security/csrf"-Method Get -Headers@{"Accept" = "application/json""Authorization" = "Basic $base64"} -UseBasicParsing$csrfToken = ($csrfResp.Content | ConvertFrom-Json).items[0].attributes.nonceWrite-Host"CSRF Token: $($csrfToken.Substring(0,30))..."Write-Host""# 正确的 FolderInfo 格式$folderData = @{"contextId" = "OR:wt.pdmlink.PDMLinkProduct:2066651""name" = "TestAPIFolder""description" = "通过 REST API 创建的测试文件夹"} | ConvertTo-JsonWrite-Host"请求数据:"Write-Host$folderDataWrite-Host""# 创建文件夹$foldersUrl = "$baseUrl/servlet/rest/v1/folders"try {$createResp = Invoke-WebRequest-Uri$foldersUrl-Method Post -Headers@{"Accept" = "application/json""Content-Type" = "application/json""Authorization" = "Basic $base64""CSRF_NONCE" = $csrfToken    } -Body$folderData-UseBasicParsingWrite-Host"✅ 创建成功! 状态: $($createResp.StatusCode)"Write-Host"响应:"Write-Host$createResp.Content} catch {Write-Host"❌ 创建失败: $($_.Exception.Response.StatusCode.value__)"if ($_.Exception.Response -ne$null) {try {$stream = $_.Exception.Response.GetResponseStream()$stream.Position = 0$reader = New-Object System.IO.StreamReader($stream)$errorBody = $reader.ReadToEnd()$reader.Close()$stream.Close()Write-Host"错误详情: $errorBody"        } catch {Write-Host"读取错误详情失败: $_"        }    }}Write-Host""Write-Host"=== 完成 ==="

• 登录Windchill系统检查“文件夹”已创建：

    此次实战基于“Windchill 11.0 M030”环境，作为代码小白，初期用OpenClaw调用API接口“新建用户”时反复失败，一度陷入困境。但通过沉下心学习API文档，最终明确核心问题——Windchill 11.0本身没有REST API创建用户的功能，这才避免了无效调试，节省了大量时间。

    虽然新建用户的目标未能实现，但通过持续探索，成功完成了“查询用户”和“新建文件夹”两个核心场景的实战；另外，让OpenClaw写了一个简单的前端页面可查询Windchill用户。

    在PLM学习和实战的道路上，没有一蹴而就的成功，每一次异想天开的尝试，每一次灵光一现的思路，都是成长的印记。也希望各位正在探索PLM的小伙伴，不要畏惧失败，多查文档、多做尝试，在实战中积累经验，在探索中稳步前行，不负每一份坚持与热爱！