用途:arch 处理根级软件工程架构任务,包括系统设计、创建架构决策记录(ADR)、执行权衡分析和选择技术栈。它集成 OpenClaw 核心引擎,输出结构化产物,如图表、文档或 JSON 报告。
适用时机:启动新系统设计、评估架构决策或解决技术选型权衡时使用;适用于项目启动、重构或系统扩展,尤其是微服务、云基础设施或分布式系统等复杂应用。
主要能力:生成 Markdown 格式 ADR,含上下文、决策与后果等章节;使用预定义模型(如分布式系统的 CAP 定理)分析权衡;根据需求、约束和性能指标等输入推荐技术栈;通过与 PlantUML 等工具集成生成系统设计图;支持通过反馈循环迭代完善设计。
使用方式:通过 OpenClaw CLI 或 API 调用,支持交互式或脚本化工作流。命令以 openclaw arch 为前缀。设计系统:openclaw arch design --input design.json --output system.md。创建 ADR:openclaw arch adr --title "Use Microservices" --context "Monolith limitations" --decision "Adopt microservices"。分析权衡:openclaw arch tradeoff --options "monolith,microservices" --criteria "scalability,cost"。选择技术栈:openclaw arch techstack --requirements "high-availability,nodejs" --constraints "budget:low"。API 端点如 POST /api/skills/arch/tradeoff,请求体为 {"options": ["monolith"], "criteria": ["cost"]}。API 调用需设置 $OPENCLAW_API_KEY,例如 curl -H "Authorization: Bearer $OPENCLAW_API_KEY" -X POST https://api.openclaw.ai/api/skills/arch/design。输入建议使用 JSON 文件,输出用 --output 标志,避免直接修改文件。
集成与错误处理:可通过 CLI 管道或 API 链式调用集成到工作流,本地执行依赖 Node.js 运行时。可挂钩 Git 预提交验证设计,如 openclaw arch validate --file architecture.md && git commit。常见错误包括输入无效(如缺少 JSON 字段)或认证失败;API 返回 HTTP 401 时检查 $OPENCLAW_API_KEY,CLI 报 "Invalid flag" 返回退出码 1。可用 jq 校验 JSON 模式。
关系:与 se-design(详细实现)、se-implementation(代码级集成)相关;依赖 core-engine(处理)和 se-tools(可视化工具);无直接冲突,但应避免与 se-security 在访问控制上重叠。
限制:资料未提供收费、价格、平台支持范围或具体效果数据。