You need to enable JavaScript to run this app.
文档中心
ArkClaw 企业版

ArkClaw 企业版

复制全文
下载 pdf
智能体升级
为存量 ArkClaw 实例启用或更新安全防护
复制全文
下载 pdf
为存量 ArkClaw 实例启用或更新安全防护
在安全管理模块开通 AgentSentry 服务后,新建的 ArkClaw 企业版实例会自动接入安全防护。如果你希望为存量 ArkClaw 企业版实例开启安全防护,或将 ArkClaw 实例安装的 AgentSentry 版本升级至最新,可以参考本文档操作。​
该操作适用于以下场景下的 ArkClaw 企业版实例:​
  • 开通 AgentSentry 服务之前创建的 ArkClaw 企业版实例,即从未安装过防护插件。​
  • 开通 AgentSentry 服务之后创建的 ArkClaw 企业版实例,但希望升级到最新防护版本。​
  • 开通 AgentSentry 服务之后创建的 ArkClaw 企业版实例,手动卸载了插件,需要重新安装。​
注意事项​
  • 当前火山引擎 AgentSentry 最新插件版本为 1.9.1。​
  • 版本兼容性:兼容火山引擎 ArkClaw 1.2.0 或更新版本。如果为历史版本,需要先前往批量运维 > 版本管理模块,执行 ArkClaw 实例升级。​
前提条件​
  • 管理员已在 ArkClaw 企业版控制台开通 AgentSentry 服务。详情请参考开通安全防护。​
  • 员工已创建 ArkClaw 实例。​
  • 执行升级操作的账号需具备以下权限​
  • ArkClawFullAccess:用于获取 ArkClaw 企业版读写权限​
  • ClawSentryFullAccess:用于获取 AgentSentry 读写权限​
  • ​​​
操作步骤​
  1. 在左菜单栏,选择运维管理 > 批量运维,单击创建作业。​
  • ​​​
  1. 配置作业相关信息。​
  1. 填写作业名称。​
  1. 将修改后的代码示例粘贴到系统预设命令下方(自第 10 行开始),注意保留原有命令。​
注意​
系统预设 Shell 内容无法修改,请从第 10 行开始输入。​
  • ​​​
  1. 单击添加选择执行对象。​
  • ​​​
  1. 选择目标执行对象,然后单击确定。​
  • ​​​
  • 创建完成后,可以在作业列表中看到新创建的作业。​
  • ​​​
  1. 待状态变为执行成功后,前往安全管理列表,查看升级的 Claw 实例版本。​
说明​
版本号为 1.9.1 则表示已经升级为最新。​
代码示例​
以下代码用于批量运维作业中执行相关命令,请复制后替换对应参数值使用,参数获取方式请参考下文参数说明。​
注意​
注意替换代码中的参数值(6 至 12 行)。​
代码详情​
​
参数说明​
调用接口注册服务前,请先获取以下参数。​
​
配置项​
数据类型​
是否必填​
说明​
VOLC_SECRET_KEY ​
String ​
是 ​
  • 已经开通 AgentSentry 服务账号拥有的 Secret Access Key 和 Access Key ID。 ​
说明​
  • 请使用主账号对应的 Secret Access Key 和 Access Key ID。 ​
  • 如需使用子账号配置,请授予 ClawSentryFullAccess和ArkClawFullAccess权限。授权操作方法请参见如何为子账号授予权限。 ​
VOLC_ACCESS_KEY_ID​
String ​
是 ​
​
SPACE_ID​
String​
是​
  • ArkClaw 企业版的空间 ID。​
  • 获取方式:​
  1. 在空间概览模块获取空间 ID,例如csi-****。​
​​​
REGION​
String​
否​
  • ArkClaw 所属地域。​
  • 华北2(北京):cn-beijing​
  • 华东2(上海):cn-shanghai​
  • 获取方式:​
  1. 在顶部菜单栏查看服务所属地域。​
​​​
TARGET_VERSION​
String​
是​
  • 需要升级的 AgentSentry 目标版本。​
CONFIG_FILE​
String ​
否​
  • OpenClaw 配置文件(openclaw.json)所在路径,默认为/root/.openclaw/openclaw.json,不填则使用默认路径。​
  • 获取方式:可以直接通过 AI 助手来获取详细路径,或在终端使用命令find / -name openclaw.json查找。 ​
NAME​
String​
否​
  • 保持留空。​
  • 需要自定义单个助手在安全管理模块显示的名称时,可以配置。​
  • 批量升级多个 ArkClaw 助手时请勿配置,否则会覆盖多个助手的名称信息。​
USER_UID​
String​
否​
  • 保持留空。​
  • 需要自定义单个助手在安全管理模块所属用户的唯一标识时,可以配置。​
  • 批量升级多个 ArkClaw 助手时请勿配置,否则会覆盖多个助手的所属用户信息。​
​
常见问题​
如何确认 ArkClaw 的版本?​
ArkClaw 的不同版本对应不同的 OpenClaw 框架版本,查看方式如下:​
  1. 在左侧导航栏中,选择实例列表。​
  1. 在实例列表中,查看 ArkClaw 实例对应的当前版本。​
  • ​​​
如何为子账号授予权限?​
为多个子账号批量授予同一权限​
  1. 使用主账号登录 IAM 控制台。 ​
  1. 在左侧导航栏中,选择权限策略。 ​
  1. 在搜索框中输入对应权限名称,并按下回车。 ​
  • ArkClawFullAccess:用于获取 ArkClaw 企业版读写权限​
  • ClawSentryFullAccess:用于获取 AgentSentry 读写权限​
  1. 在搜索结果中,单击策略对应的授权。 ​
  • ​​​
  1. 勾选需要授权的子账号用户。 ​
  • ​​​
  1. 确认后,单击提交。 ​
授权后,该子账号的 AK 和 SK 可用于运维操作。​
为同一子账号批量授予多个权限​
  1. 使用主账号登录 IAM 控制台。 ​
  1. 在左侧导航栏中,选择用户。 ​
  1. 在搜索框中输入对应用户名称,并按下回车。 ​
  1. 在搜索结果中,单击用户对应的添加权限。​
  • ​​​
  1. 分别搜索以下权限名,并勾选。​
  • ArkClawFullAccess:用于获取 ArkClaw 企业版读写权限​
  • AgentSentryFullAccess:用于获取 AgentSentry 读写权限​
  • ​​​
  1. 确认后,单击提交。 ​
授权后,该子账号的 AK 和 SK 可用于运维操作。​
运维作业执行成功,但助手版本没更新是什么原因?​
  • 原因:可能是因为执行升级的账号不具备相关权限。​
  • 排查:​
  1. 单击作业对应的执行结果。​
  • ​​​
  1. 单击查看日志。​
  • ​​​
  1. 查看失败报错信息。​​​
  • 如果提示“User is not authorized to perform: arkclaw:GetClawInstance on resource:”,则表示账号缺少ArkClawFullAccess权限。​
  • 解决方案:请参考如何为子账号授予权限为账号添加ArkClawFullAccess权限。​
最近更新时间:2026.10.09 20:22:20
这个页面对您有帮助吗?
有用
有用
无用
无用