用于创建一个新的PolarClaw Agent
接口说明
请求说明
通过此 API，用户能够创建一个 PolarClaw Agent，并且可以选择性地为其设置Emoji（表情）与Avatar（头像）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ApplicationId |
string |
是 |
应用 ID |
pa-************** |
| AgentId |
string |
是 |
Agent 名称 |
work |
| Workspace |
string |
是 |
Agent 工作目录绝对路径 |
/home/node/.openclaw/workspace-work |
| Emoji |
string |
否 |
Emoji 字符 |
U+1F99E |
| Avatar |
string |
否 |
头像 URL 或路径 |
test |
| Restart |
boolean |
否 |
创建后是否重启网关，默认 true |
true |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF |
| Message |
string |
返回消息 |
successful |
| Code |
integer |
返回状态码 |
200 |
| ApplicationId |
string |
应用 ID |
pa-************** |
| AgentId |
string |
Agent ID |
work |
| Name |
string |
Agent 名称 |
work |
| Workspace |
string |
工作目录路径 |
/home/node/.openclaw/workspace-work |
| Agent |
object |
创建的 Agent 详情 |
|
| Id |
string |
Agent ID |
work |
| Name |
string |
Agent 显示名称 |
work |
| Identity |
object |
身份标识信息 |
|
| Name |
string |
身份名称 |
work |
| Theme |
string |
主题 |
work |
| Emoji |
string |
Emoji 标识 |
U+1F99E |
| Avatar |
string |
头像路径或内容 |
test |
| AvatarUrl |
string |
头像 URL |
test |
| Workspace |
string |
工作目录路径 |
/home/node/.openclaw/workspace-work |
示例
正常返回示例
JSON格式
{
"RequestId": "3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF",
"Message": "successful",
"Code": 200,
"ApplicationId": "pa-**************",
"AgentId": "work",
"Name": "work",
"Workspace": "/home/node/.openclaw/workspace-work",
"Agent": {
"Id": "work",
"Name": "work",
"Identity": {
"Name": "work",
"Theme": "work",
"Emoji": "U+1F99E",
"Avatar": "test",
"AvatarUrl": "test"
},
"Workspace": "/home/node/.openclaw/workspace-work"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。