ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南CLI参考命令详解对话与会话命令
复制全文
下载 pdf对话与会话命令
文档反馈
问问助手交互式对话
arkclaw chat --clawid <ClawID>
- 执行本命令会打开连续聊天窗口；脚本管道 / JSON 输出只能单次发消息。如仅需执行单次聊天窗口后即退出对话，请执行下文 一次性消息 命令。
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- 如何退出对话：
- 在输入提示符处按 Ctrl+C 会退出。Agent 正在生成时，第一次 Ctrl+C 会请求 OpenClaw 服务端中止当前回合；需再次按下 Ctrl+C后，方可在本地取消等待，完全终止对话。
- 当前版本中，A2A 端点无法远程中断任务，仅在本地截断显示。
一次性消息
arkclaw chat --clawid <ClawID> -m "总结今天的工作"
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- 直接发起单次对话，给指定实例发送提问「总结今天的工作」，Agent 回复完成后命令立刻退出终端，不会进入交互式聊天 REPL 窗口。
指定 Agent、调试 Agent 和会话
# 指定 Agent
arkclaw chat --clawid <ClawID> --agent <AgentID> -m "你好"
# 连接该 Agent 对应的调试 Agent（如果存在）
arkclaw chat --clawid <ClawID> --agent <AgentID> --debug -m "复现这个问题"
# 续聊指定会话
arkclaw chat --clawid <ClawID> --agent <AgentID> --session <会话ID> -m "继续"
# 新建会话
arkclaw chat --clawid <ClawID> --agent <AgentID> --new -m "开始新话题"
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- --debug 仅支持在 OpenClaw 传输模式时使用。
- 共享 Claw 普通用户不支持使用调试 Agent。
附加文件和标准输入
arkclaw chat --clawid <ClawID> \
-f notes.md \
-f images/ \
-m "结合附件给出结论"
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- -f ：或 --file ，支持重复使用，既可以传文件也可以传文件夹。
- -m：一次性提问，让 Agent 读取上传的文件内容再输出总结，执行完单次对话直接退出，不会进入交互式 REPL 聊天窗口。
- -f 必须与一次性消息 -m 一起使用，不能直接用于交互式 REPL。
- 不要把 .env、~/.ssh 等敏感路径传给 -f。
- 递归扫描目录时，自动跳过内部所有 . 开头的隐藏文件 / 隐藏文件夹。例如传入普通文件夹 images/，遍历内部时会自动忽略 .git、.tmp此类以点开头的隐藏内容。
- 传入根路径文件夹时，隐藏拦截的情况如下：
- 直接指定 .env 等单个隐藏文件时，不会被拦截。
- 直接指定 .ssh 等隐藏目录时，不会直接跳过整个文件夹，只会跳过文件夹内部以 . 开头的子内容，.ssh 下普通命名文件（无.开头）依然会被收集上传。
- -f附件数量限制：最终成功上传的文件总个数、单文件大小、全部文件总容量存在以下限制，超过限制会上传失败。
-
- 管道输出的文本会自动变成名为 <stdin> 的虚拟附件上传：
- git diff | arkclaw chat --clawid <ClawID> -m "检查这个变更"
- 管道输入在当前版本中，不经过上述 -f 文件大小限制。调用方应自行限制输入规模，避免超过传输端点可接受的请求大小。
保存回复
arkclaw chat --clawid <ClawID> -m "生成周报" -o report.md
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- -o/--output ：只写最终回复，中间过程日志、报错、进度提示不会写到文件里。
- 在 Mac/Linux（POSIX）系统，该文件当前以普通 0644 权限创建，即生成的文件默认所有人可读。在多人共享服务器存放敏感内容时，建议手动修改文件权限防止信息泄露。
列出会话
arkclaw sessions --clawid <ClawID>
arkclaw sessions --clawid <ClawID> --agent <AgentID>
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- OpenClaw 传输模式时，优先从云端服务端读取会话，并按最近更新时间排序。
- 如果服务端不可达、登录已失效或处于 A2A 模式，命令会自动降级读取本地 sessions.json 记录。
- 即便降级读取本地缓存，命令退出码依然是 0（执行成功），脚本无法单纯靠 $?=0 判断数据来源是云端还是本地。因此自动化应识别返回结构并自行过滤，不能仅凭退出码判断结果是否来自服务端。
- 回退结果是本机全部历史索引，不会按本次传入的 --clawid 或 --agent 过滤。
查看历史记录
# 默认显示最后 50 条可见消息
arkclaw history <会话ID> --clawid <ClawID>
# 查看指定子 Agent 的会话历史
arkclaw history <会话ID> --clawid <ClawID> --agent <AgentID>
# 显示所有可见消息
arkclaw history <会话ID> --clawid <ClawID> --all
# 同时显示工具调用和工具结果
arkclaw history <会话ID> --clawid <ClawID> --show-tools
# 写入文本文件
arkclaw history <会话ID> --clawid <ClawID> --show-tools -o history.txt
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- history 仅支持在 OpenClaw 传输模式时使用。
- 终端仅返回会话问答文字，默认隐藏工具执行步骤。
- 参数介绍：
- --tail：用与限制只展示末尾 N 条历史（仅终端屏幕输出生效）。
- 加 -o（导出文件）或 --json（结构化输出）后，将不受 --tail 条数限制，会加载这条会话全部历史数据。
- -o 文件导出细分两种情况 ：
- 不加 --show-tools：导出文本默认剔除工具执行步骤，只保留人机对话。
- 加上 --show-tools：导出文件会附带全部工具调用、返回结果完整记录。
- --json 输出规则：无论是否加参数，结构化数据里永久包含完整问答 + 全部工具步骤，无隐藏内容。
- 在 Mac/Linux（POSIX）系统，该文件当前以普通 0644 权限创建，即生成的文件默认所有人可读。在多人共享服务器存放敏感内容时，建议手动修改文件权限防止信息泄露。
工具审批
Agent 请求执行工具时，CLI 的本地决策顺序优先级如下：
- cmdpolicy.json 的 deny 规则：只要工具命令匹配黑名单规则，直接拒绝执行。
- cmdpolicy.json 的 allow 规则：没命中黑名单，则匹配白名单；命中白名单直接自动放行。
- cmdpolicy.json 的 default=deny|allow：黑白名单都没匹配，走默认策略： allow - 自动放行所有未知命令，deny - 自动拒绝所有未知命令，ask - 弹出交互窗口，手动确认。
- --approve-all：前 3 层策略都没拦截的前提下，本参数生效，自动同意全部未知工具调用，不用手动点确认。
- 交互式终端确认：无 --approve-all、默认策略是 ask，终端弹出提示，输入 y/n 选择放行 / 拒绝。
- 无人值守时默认拒绝：管道、自动化脚本、非 TTY 环境，没有人工弹窗交互入口，所有未被白名单放行的未知命令，直接自动拒绝，防止脚本误删文件。
示例策略文件 ~/.arkclaw/cmdpolicy.json：
{
"deny": ["*rm -rf*", "*sudo*"], // 黑名单：所有删除目录、sudo管理员命令一律拦截
"allow": ["git status", "ls *"], // 白名单：查看git状态、所有ls查看文件命令自动放行
"default": "ask" // 黑白名单没匹配的命令，弹窗让我手动确认
}
- 匹配语法：glob 通配符，* 代表任意字符，模糊匹配命令文本。
- 策略文件异常兜底规则：
- 出现下面任意一种损坏情况：文件不存在 / 读不到，JSON 格式写错、无法解析，文件顶层不是 {} 对象时，CLI 的全部命令直接拒绝，保护本地环境。
- 正常 JSON、仅个别字段写错（比如写错字段名）：不会触发上面的全盘拒绝兜底，不要依靠异常兜底做安全防护，规范编写策略文件。
- 安全警告：
- cmdpolicy.json 是客户端防误操作机制，不等于安全隔离，即不是 IAM、进程沙箱或服务端权限边界。
- 命令匹配存在局限性，不能 100% 信任：
- 用来匹配的文本只是 Agent 简化后的审批摘要，可能被截断、省略完整命令参数。
- 摘要文本、弹窗提示文字都是 Agent 生成的，存在隐瞒、改写命令内容的可能性。
- 不要只看弹窗文字就放行高危操作，必须自己判断命令真实风险，陌生删除、管理员命令不要随便确认。
批量发送
arkclaw fanout "请分别报告当前状态" \
--clawid <ClawID-1> \
--clawid <ClawID-2>
- fanout 仅支持在 OpenClaw 传输模式时使用，会并行发送相同消息，即同时给多个 Claw 发送一模一样的提问。
- 如需操作企业服务智能体，请将 --clawid 替换为 --esaid 并指定目标智能体 ID。
- 并行调用失败逻辑：
- 其中某一个实例调用报错、失败，不会打断其他实例执行。
- 只要有任意实例正常返回，整条 fanout 顶层命令的退出码大概率是 0（系统判定整体执行完成）。
- 自动化规范：必须解析每条实例返回的 JSON，检查内部 ok 字段，ok: true 代表该实例请求正常，ok: false 代表失败。
- 工具审批规则：
- fanout 不支持 --approve-all（自动同意全部未知工具调用），但仍会应用 cmdpolicy.json 的 deny、allow 和 default 规则。优先级为：deny（黑名单） > allow（白名单） > default=allow （默认全部放行工具）。
- 策略结果为 ask 或没有策略明确放行时，因为 fanout 无人值守，CLI 会默认拒绝工具调用。
最近更新时间：2026.09.02 19:44:13
这个页面对您有帮助吗？
有用
有用
无用
无用