更新PolarClaw Agent。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ApplicationId |
string |
是 |
應用 ID。 |
pa-************** |
| AgentId |
string |
是 |
要更新的 Agent ID。 |
work |
| Name |
string |
否 |
新的顯示名稱。 |
Work Bot |
| Workspace |
string |
否 |
新的工作目錄路徑。 |
/home/node/.openclaw/workspace-work-v2 |
| Model |
string |
否 |
模型覆蓋。 |
claude-sonnet-4-5 |
| Avatar |
string |
否 |
新的頭像。 |
test |
| Files |
array<object> |
否 |
要更新的檔案列表。 |
[{"FileName":"SOUL.md","FileContent":"You are a helpful assistant."}] |
|
object |
否 |
檔案列表。 |
||
| FileName |
string |
否 |
檔案名稱，須為允許的檔案名稱之一（AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md、MEMORY.md、MEMORY.alt.md）。 |
SOUL.md |
| FileContent |
string |
否 |
檔案內容。 |
You are a helpful assistant. |
| Restart |
boolean |
否 |
建立後是否重啟閘道，預設 true。 |
true |
| IsDefault |
boolean |
否 |
設為預設 Agent。 |
true |
| KeepWorkspaceFiles |
boolean |
否 |
切換 workspace 時保留檔案。 |
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
CDB3258F-B5DE-43C4-8935-CBA0CA****** |
| Message |
string |
回傳訊息。 |
successful |
| Code |
integer |
回傳狀態碼。 |
200 |
| ApplicationId |
string |
應用 ID。 |
pa-************** |
| AgentId |
string |
Agent ID |
main |
| Agent |
object |
更新後的 Agent 詳情。 |
|
| Id |
string |
Agent ID |
main |
| Name |
string |
Agent 顯示名稱。 |
PolarClaw |
| Identity |
object |
身份標識資訊。 |
|
| Name |
string |
身分名稱 |
PolarClaw |
| Theme |
string |
主題 |
soul lobster |
| Emoji |
string |
Emoji 識別（Unicode 編碼格式如 U+1F99E，或直接 emoji 字元） |
U+1F99E |
| Avatar |
string |
頭像路徑或內容 |
test |
| AvatarUrl |
string |
頭像 URL |
test |
| Workspace |
string |
工作目錄路徑。 |
/home/node/.openclaw/workspace-work-v2 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******",
"Message": "successful",
"Code": 200,
"ApplicationId": "pa-**************",
"AgentId": "main",
"Agent": {
"Id": "main",
"Name": "PolarClaw",
"Identity": {
"Name": "PolarClaw",
"Theme": "soul lobster",
"Emoji": "U+1F99E",
"Avatar": "test",
"AvatarUrl": "test"
},
"Workspace": "/home/node/.openclaw/workspace-work-v2"
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。