文档中心

ArkClaw 企业版

请输入

命令详解

Agent 管理

agents 是推荐命令组；agent 是等价别名。

列出 Agent

arkclaw agents​
arkclaw agents --clawid <ClawID>​

在线核验成功时，结果只包含当前身份能够访问的 Agent，无权访问或已删除的 Claw 会从本机历史视图中移除。

网络或认证失败时，CLI 可能显示未经核验的本地历史，并在终端中给出提示；不要把离线列表当作当前授权证明。

创建 Agent

arkclaw agents create \​
  --clawid <ClawID> \​
  --name "数据分析助手" \​
  --role "分析数据并解释结果" \​
  --soul "回答时给出数据依据和不确定性" \​
  --description "团队数据分析助手"​

参数介绍：

--name、--role 和 --soul 必填且不能为空。

--name：不能是 main（主 Agent），也不能以 a- 开头。

--skill ：可重复使用以启用多个技能。

共享 Claw 不允许通过 CLI 创建或删除 Agent，包括共享 Claw 管理员。此类操作应在允许的私人 Claw 或对应管理界面中完成。

删除 Agent

arkclaw agents delete <AgentID> --clawid <ClawID>

支持使用 Agent ID 或 Agent 名称。当 Agent 名称对应了多个 Agent 时，CLI 会拒绝操作并要求改用 ID。

主 Agent 和默认 Agent 不能删除。

交互式终端会要求手动确认（y/n）是否删除 Agent，无人值守调用时必须显式使用：

arkclaw agents delete <AgentID> --clawid <ClawID> --yes # yes 表示自动确认高危删除操作，跳过人工弹窗确认 ​

管理 Agent Pack

Agent Pack 是智能体安装包，即一套完整打包好的 Agent 资源合集，包含：提示词配置、MCP 工具声明、技能脚本、依赖文件、输入输出定义、版本配置文件等，用来一键导入部署到 Claw 实例。

校验 Agent Pack

arkclaw agents validate ./my-agent-pack

该命令完全在本地执行，不需要登录，用于自动扫描、检查这套包文件是否合规、无错误，防止部署失败。

./my-agent-pack中目录必须包含合法的 manifest.json。除此之外，CLI 还会检查：

scripts/install.sh 的 Shell 语法。

Agent、配置和 skills lock 的语义化版本一致性。

cron 配置和环境变量声明的安全约束。

本地 Skill 的完整性及禁止的数据源。

部署 Agent Pack

arkclaw agents deploy ./my-agent-pack \​
  --clawid <ClawID> \​
  --agent <AgentID>​

仅支持在 OpenClaw 传输模式时使用。共享 Claw 普通用户不能部署，共享 Claw 管理员是否可部署仍取决于服务端权限。

部署流程：

本地校验：部署前会自动执行本地校验。

本地打包：把你的 Agent 文件夹压缩为安装包。

分片上传：包文件较大时自动拆分多段上传，避免单次超大文件传输失败。

云端安装：服务端接收完整安装包，完成智能体配置更新、技能加载。

Pack 内不允许符号链接：

本地文件夹里如果存在软链接文件 / 软链接目录（ln -s），部署校验会直接失败。

--debug参数介绍：

未使用本参数时，部署将覆盖正式线上 Agent 版本；使用本参数时，仅更新该 Agent 的调试版本，不改动线上业务实例，适合开发测试，不影响线上服务。

执行部署命令返回 exit code=0时：

仅代表「本地校验 + 文件上传成功，服务端接收任务」，不代表安装完成、生效，即安装状态仍可能是 succeeded、pending 或 dry_run：

succeeded：安装全部完成，Agent 新版本已生效。

pending：云端收到安装包，正在后台解压、加载配置，还没完工。

dry_run：演练模式，只做校验 + 上传模拟，没有真实覆盖 / 更新 Agent。

自动化规范脚本拿到返回 JSON 后，必须读取 data.install.status 字段判断真实结果：

pending：表示部署请求已受理，但尚未完成。请通过控制台或相应服务接口确认最终状态。

dry_run：代表未实际部署，不能视为发布成功。

最近更新时间：2026.07.23 17:31:53

这个页面对您有帮助吗？

有用

无用