OpenClaw CLI

安全高效地运行 OpenClaw 命令。选择合适的命令系列，在正确的配置文件上下文中执行，并验证后置条件。

执行工作流

1. 明确目标状态。 询问哪些内容应更改，哪些必须保持不变。

2. 首先选择运行时范围。 除非请求隔离，否则使用默认配置文件。使用：

• openclaw --dev ...用于在~/.openclaw-dev目录下的隔离开发状态。
• openclaw --profile <名称> ...用于在~/.openclaw-<名称>目录下的命名隔离状态。

3. 选择命令系列。 使用references/command-map.md文件快速定位请求。

4. 运行风险操作前，先扩展命令详情。 对于标记为重要的命令系列，请运行openclaw <命令> --help并确认相关标志。

5. 当需要自动化时，优先使用机器可读的输出。 使用--json（如果有的话），然后进行解析/验证。

6. 明确验证结果。 通过openclaw status、openclaw health、openclaw nodes status --json或特定命令的后续操作进行检查。

安全规则

• 在reset（重置）、uninstall（卸载）、破坏性的--force（强制）流程或凭证清除操作之前，需要明确的用户确认。
• 优先使用非破坏性诊断：status（状态）、health（健康检查）、doctor,日志.
• 在整个工作流程中保持配置文件使用的一致性。请勿意外混用默认和--dev/--profile命令。
• 对于网关问题，除非明确要求重启，否则请在重启前进行诊断。

排查步骤

对于一般的"OpenClaw 无法工作"问题：

1. 运行openclaw status.
2. 运行openclaw health.
3. 运行openclaw doctor.
4. 检查openclaw gateway ...、openclaw node ...，或openclaw 节点...基于故障出现的位置。
5. 升级至有针对性的命令，位于references/command-map.md文件中。

资源

• references/command-map.md：命令族、路由指南及实用操作步骤。