命令结构

一般形式为：

推荐优先使用显式选项，例如：

sessions 的 Claw ID 必须通过 --clawid 提供，不允许写成位置参数。

命令占位符

命令中常见占位符如下，执行前需替换为实际值。

占位符	含义
<空间登录地址>	ArkClaw 企业空间（即员工端）登录地址
<ClawID>	Claw 实例 ID，格式通常为 ci-...
<AgentID>	Agent ID，格式通常为 a-...；主 Agent 为 main
<会话ID>	arkclaw sessions 返回的会话 ID
<任务ID>	arkclaw cron list 返回的定时任务 ID
<网盘SpaceID>	arkclaw netdisk create-space 返回的网盘空间 ID

获取帮助和命令 Schema

供程序读取的命令表面：

Schema 包含命令名、帮助文本、选项名和必填信息，但不承诺包含所有参数类型、默认值或业务约束。agent 是 agents 的等价别名，因此当前输出会同时列出两组名称不同但语义等价的条目；统计或生成命令列表时应只保留 agents 组，或自行去重。精确行为仍需结合命令帮助和本指南。

传输模式与能力范围

人类输出和 JSON 输出

默认模式面向终端用户，表格、普通消息和多数进度信息输出到 stdout；错误和聊天等待动画输出到 stderr。

多数业务命令支持 --json：

在 JSON 模式下：

例外：

arkclaw cron rm --json 未带 --yes 时仍会向 stdout 输出确认提示，取消或输入结束后还可能返回成功 JSON 并退出 0；脚本必须显式使用 --yes 并检查 removed 字段。

JSON 中的 Agent 返回内容按原始数据保留，不做终端控制字符清洗。程序必须把这些字段当作不可信输入，不应直接拼接到 Shell、HTML 或其他可执行上下文。