ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考TemplateUpdateSpaceTemplate - 更新一个自定义Claw模板
复制全文
下载 pdfUpdateSpaceTemplate - 更新一个自定义Claw模板
文档反馈
问问助手更新一个自定义Claw模板。
请求参数
Action string 必选 示例值：UpdateSpaceTemplate
要执行的操作，取值：UpdateSpaceTemplate。
Version string 必选 示例值：2026-05-01
API的版本，取值：2026-05-01。
AgentMd string 可选 示例值：\# 群聊规范：在回复问题前必须对问题有明确的理解，如果有不明确的地方，务必反问用户。
Agent配置文件内容，JSON格式。
- 传入具体值：更新为指定内容。
- 不传此参数：保留现有配置，不做修改。
- 传入空字符串：清空当前配置。
Description string 可选 示例值：demo description
自定义Claw模板描述。
- 长度限制为200以内的字符。
- 不填默认为空。
ImageId string 可选 示例值：cimg-yeqssiu****
公共镜像ID。
InitScript string 可选 示例值：IyEvYmluL2Jhc2gKZWNoby****
实例自定义初始化脚本，必须经过Base64编码，编码前大小不超过 12KB。
PluginConfig string 可选 示例值：{"plugins":[{"id":"agent-identity","name":"agent-identity","display_name":"Agent Identity","type":"","blacklist":false,"source":"global:agent-identity/****","version":"0.4.5"},{"id":"openclaw-lark","name":"openclaw-lark","display_name":"Feishu / Lark","type":"","blacklist":false,"source":"global:openclaw-lark/****","version":"****"},{"id":"****","name":"****","display_name":"****","type":"","blacklist":false,"source":"global:****/****","version":"****"}]}
插件配置文件内容，JSON格式。
SeatTypes.N string[] 可选 示例值：SeatTypes.1=Starter&SeatTypes.2=Standard
ArkClaw席位类型。
- 参数 - N：表示席位的序号，取值范围：1～4。
- 多个席位类型之间用&分隔。
- 取值：
- Starter：轻量版。
- Standard：标准版。
- Premium：高级版。
- Ultimate：旗舰版。
SkillConfig string 可选 示例值：{"skills":[{"name":"browser","display_name":"Browser","description":"Browser automation. When you need to visit a webpage, open a website, take a screenshot, or perform browser automation.","blacklist":false,"category":"preset"},{"name":"byted-web-search","display_name":"联网搜索","description":"****","blacklist":false,"category":"preset"},{"name":"****","display_name":"****","description":"****","blacklist":false,"category":"enterprise"}]}
技能配置文件，JSON格式。
Soul string 可选 示例值：\# SOUL.md - 销售增长引擎 ## 身份内核 你是一位顶级的资深销售顾问，擅长挖掘客户痛点并将其转化为业务机会。你的目标是提高转化率和客户满意度。 ## 核心原则 - \*\*ROI 导向\*\*：在任何方案中，务必先计算并强调客户的投入产出比。 - \*\*主动跟进\*\*：如果客户在对话中表现出犹豫，主动提议演示（Demo）或提供案例研究。 - \*\*CRM 同步\*\*：每一次关键对话结束，必须提醒用户同步更新 CRM 系统状态。 ## 沟通风格 - 充满激情、富有说服力。 - 严禁使用“可能”、“大概”，使用确定的增长数据。
职位人设的系统提示词。
SoulName string 可选 示例值：销售专家
人设类型。
- 可基于模板选择公共镜像内的人设配置，如：销售专家、运营专家、HR 人力资源、财务专家等。
- 若是自定义人设类型，SoulName为空。
SpaceId string 必选 示例值：csi-yei8347ta8xmf5qd****
ArkClaw空间ID，可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。
TemplateDisplayName string 可选 示例值：QXIVzK1zn
模板显示名称。
TemplateId string 必选 示例值：ctpl-yeqlflu0****
模板ID。可在ArkClaw控制台“模板中心”页面的“Claw模板”页签下获取。
ClientToken string 可选 示例值：23fa21A8823nfasd7f****
保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。
取值：仅支持ASCII字符，且不能超过64个字符。
DryRun boolean 可选 示例值：false
是否仅做参数和权限检查而不实际执行操作。取值：
- true：仅做检查，校验通过返回DryRunOperation错误码。
- false（默认）：实际执行操作。
返回参数
请求示例
POST /?Action=UpdateSpaceTemplate&Version=2026-05-01&SeatTypes.1=SeatTypes.1%3DStarter%26SeatTypes.2%3DStandard HTTP/1.1
Host: https://arkclaw.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260826T104334Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260826/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
"AgentMd": "\\# 群聊规范：在回复问题前必须对问题有明确的理解，如果有不明确的地方，务必反问用户。",
"Description": "demo description",
"ImageId": "cimg-yeqssiu****",
"InitScript": "IyEvYmluL2Jhc2gKZWNoby****",
"PluginConfig": "{\"plugins\":[{\"id\":\"agent-identity\",\"name\":\"agent-identity\",\"display_name\":\"Agent Identity\",\"type\":\"\",\"blacklist\":false,\"source\":\"global:agent-identity/****\",\"version\":\"0.4.5\"},{\"id\":\"openclaw-lark\",\"name\":\"openclaw-lark\",\"display_name\":\"Feishu / Lark\",\"type\":\"\",\"blacklist\":false,\"source\":\"global:openclaw-lark/****\",\"version\":\"****\"},{\"id\":\"****\",\"name\":\"****\",\"display_name\":\"****\",\"type\":\"\",\"blacklist\":false,\"source\":\"global:****/****\",\"version\":\"****\"}]}",
"SkillConfig": "{\"skills\":[{\"name\":\"browser\",\"display_name\":\"Browser\",\"description\":\"Browser automation. When you need to visit a webpage, open a website, take a screenshot, or perform browser automation.\",\"blacklist\":false,\"category\":\"preset\"},{\"name\":\"byted-web-search\",\"display_name\":\"联网搜索\",\"description\":\"****\",\"blacklist\":false,\"category\":\"preset\"},{\"name\":\"****\",\"display_name\":\"****\",\"description\":\"****\",\"blacklist\":false,\"category\":\"enterprise\"}]}",
"Soul": "\\# SOUL.md - 销售增长引擎 ## 身份内核 你是一位顶级的资深销售顾问，擅长挖掘客户痛点并将其转化为业务机会。你的目标是提高转化率和客户满意度。 ## 核心原则 - \\*\\*ROI 导向\\*\\*：在任何方案中，务必先计算并强调客户的投入产出比。 - \\*\\*主动跟进\\*\\*：如果客户在对话中表现出犹豫，主动提议演示（Demo）或提供案例研究。 - \\*\\*CRM 同步\\*\\*：每一次关键对话结束，必须提醒用户同步更新 CRM 系统状态。 ## 沟通风格 - 充满激情、富有说服力。 - 严禁使用“可能”、“大概”，使用确定的增长数据。",
"SoulName": "销售专家",
"SpaceId": "csi-yei8347ta8xmf5qd****",
"TemplateDisplayName": "QXIVzK1zn",
"TemplateId": "ctpl-yeqlflu0****",
"ClientToken": "23fa21A8823nfasd7f****",
"DryRun": true
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260722161041116011****",
"Action": "UpdateSpaceTemplate",
"Version": "2026-05-01",
"Service": "arkclaw",
"Region": "cn-beijing"
},
"Result": {}
}
错误码
最近更新时间：2026.09.08 14:33:38
这个页面对您有帮助吗？
有用
有用
无用
无用