运行自检

doctor 检查内容如下：

doctor 仅在检出 fail 项时返回退出码 1；仅 warn/skip 不会标记不健康，正常返回 0。

常见错误码

错误码	含义	建议处理
ARKCLAW_E_NOLOGIN	没有可用登录态	运行 arkclaw login
ARKCLAW_E_EXPIRED	Token 过期且无法刷新	重新登录
ARKCLAW_E_TOKEN	Token 或本地会话配置不可读	检查文件权限并重新登录
ARKCLAW_E_STS	STS 交换失败	检查空间的 OIDC 信任和 STS role 配置
ARKCLAW_E_FORBIDDEN	当前用户无权访问 Claw 或操作	核对 Claw ID、共享角色并联系管理员
ARKCLAW_E_TERMINAL_FORBIDDEN	没有运行时终端权限	申请独立的终端授权
ARKCLAW_E_NOCLAW	没有默认 Claw 且未显式指定	增加 --clawid <ClawID>
ARKCLAW_E_NETWORK	网络或端点不可达	检查网络、代理、区域和 endpoint
ARKCLAW_E_CLIENT_UPGRADE_REQUIRED	服务端要求更高版本 CLI	升级后重试

常见问题

arkclaw 命令不存在

确认安装工具所在目录已经加入 PATH，重新打开终端并运行：

登录后仍提示过期

运行：

如果 CLI 正在使用 Chrome 兜底登录，则首先在 Chrome 中重新登录同一空间，再立即重试 CLI。

浏览器登录等待超时

确认授权页面完成登录，且浏览器可以回调发起命令的同一台机器。代理环境可配置 NO_PROXY=127.0.0.1。

agents 列表为空

这不表示空间中没有 Claw，需取得一个有权限的 Claw ID 后运行：

sessions 返回的内容和网页不一致

命令可能因服务端不可达而回退到本地记录。先运行 arkclaw doctor，确认登录和控制面可达，再重新查询。

文件命令提示未启用 Silk

目标 Claw 没有启用工作区文件服务。受管文件命令和 Silk 工作区是两套能力；可以先用不带路径的 arkclaw ls 检查受管文件，或联系管理员启用 Silk。

cron status 显示调度器未启用

该 Claw 运行时没有启用定时任务能力。更换支持调度器的 Claw，或联系管理员。

JSON 无法解析

确认只解析 stdout，不要合并 stderr。命令行参数解析错误、version 和 terminal 也不遵循标准业务 JSON 信封。