Reference 0003

Agent 架构选型 Checklist

用一组问题判断该选 Claude Code 型、OpenClaw 型、Hermes 型，还是需要自建 harness。

1. 选型问题

条目	说明
任务域	主要是代码库改动、个人助理、多 channel bot，还是跨 runtime 协作？
执行风险	是否运行 shell、修改文件、发消息、访问外部 API、长期自动化？
状态需求	只需要当前 session，还是需要 project memory、user memory、external memory provider？
协作需求	单 agent 足够，还是需要 subagent、multi-agent routing、manager-worker？

2. 决策规则

条目	说明
Claude Code 型	代码库任务优先，重点控制 repo、Bash、Edit、hooks、permissions。
OpenClaw 型	自托管 Gateway、多 channel、多 isolated agents 优先。
Hermes 型	terminal automation、bots、多 provider、多 sandbox backend、长期记忆优先。
Harness 型	多个 runtime、多用户、多权限、多生命周期、多审计要求同时出现。

3. 风险门槛

如果出现	必须补齐	否则会怎样
agent 能执行 shell、写文件或访问外部 API	权限分级、审批、sandbox、tool audit、失败回滚。	一次提示污染就可能造成真实副作用。
agent 有长期 memory 或 external memory provider	write policy、source、confidence、TTL、删除和审计。	错误记忆会跨会话污染，且难以追踪和清理。
agent 需要多 agent 协作	routing policy、handoff payload、状态隔离、结果验收。	上下文丢失、重复执行、责任边界不清。
agent 面向团队或企业部署	身份、租户隔离、日志、trace、配置版本、运维手册。	demo 能跑，但无法定位事故和长期维护。