更新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"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。