DescribePolarClawAgents - PolarDB

查詢指定應用下所有已安裝的外掛程式及其狀態資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardb:DescribePolarClawAgents

none

*全部資源。

*

無

請求文法

POST  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
ApplicationId	string	是	應用 ID。	pa-**************
AgentList	array	否	選擇要描述的 Agent ID 列表。	work,research
	string	否	Agent 列表。	work

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	Id of the request	24A1990B-4F6E-482B-B8CB-75C612******
Message	string	返回訊息。	successful
Code	integer	返回狀態碼。	200
ApplicationId	string	應用 ID。	pa-**************
DefaultId	string	預設 Agent ID。	main
MainKey	string	主 Agent 鍵名。	main
Scope	string	路由作用域。	per-sender
Agents	array<object>	Agent 列表。
	array<object>	Agent
Id	string	Agent ID	main
Name	string	Agent 顯示名稱。	main
Identity	object	身份標識資訊。
Name	string	身分名稱	PolarClaw
Theme	string	主題	space lobster
Emoji	string	Emoji 標識（Unicode 編碼格式如 U+1F99E，或直接 emoji 字元）	U+1F99E
Avatar	string	頭像路徑或內容	test
AvatarUrl	string	頭像 URL	test
Workspace	string	工作目錄路徑。	/home/node/.openclaw/workspace-work
Default	boolean	是否為預設 Agent。	true
Model	object	模型配置。
Primary	string		claude-sonnet-4-5
Fallbacks	array
	string		claude-haiku-4-5
Skills	array	Agent 可用的 Skill 列表。
	string	Skill 標識。	alibacloud-rds-copilot
Files	array<object>	Agent 檔案列表。
	object	檔案資訊。
Name	string		SOUL.md
Path	string		/home/node/.openclaw/workspace-work/SOUL.md
Missing	boolean		false
Size	integer		1024
UpdatedAtMs	integer		1716000000000

樣本

正常返回樣本

JSON格式

{
  "RequestId": "24A1990B-4F6E-482B-B8CB-75C612******",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "DefaultId": "main",
  "MainKey": "main",
  "Scope": "per-sender",
  "Agents": [
    {
      "Id": "main",
      "Name": "main",
      "Identity": {
        "Name": "PolarClaw",
        "Theme": "space lobster",
        "Emoji": "U+1F99E",
        "Avatar": "test",
        "AvatarUrl": "test"
      },
      "Workspace": "/home/node/.openclaw/workspace-work",
      "Default": true,
      "Model": {
        "Primary": "claude-sonnet-4-5",
        "Fallbacks": [
          "claude-haiku-4-5"
        ]
      },
      "Skills": [
        "alibacloud-rds-copilot"
      ],
      "Files": [
        {
          "Name": "SOUL.md",
          "Path": "/home/node/.openclaw/workspace-work/SOUL.md",
          "Missing": false,
          "Size": 1024,
          "UpdatedAtMs": 1716000000000
        }
      ]
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。