用途:当请求授权、会话行为、存储持久化或元数据形态出现问题时可使用本技能,用于排查 vercel-openclaw 中认证与存储相关故障。
主要能力:先收集证据,包括从 admin/preflight 接口获取认证模式与 Vercel/本地环境;记录请求方法、路由、状态码及使用的是 bearer 还是 cookie 认证;按 auth.、store.、session.、preflight. 过滤 GET /api/admin/logs;查看部署契约报告的存储后端;必要时获取脱敏后的元数据形态。禁止打印密钥、会话键、Redis URL 或 Cookie。
关键区分:部署保护认证与应用认证不同;bearer admin-secret 认证与加密会话 Cookie 认证不同;CSRF 只作用于基于 Cookie 的变更,不作用于 bearer 变更;LOCAL_READ_ONLY=1 会在本地有意阻止 admin 变更;Redis 仅在部署到 Vercel 运行时连接,本地/CI 即使存在 Redis 环境变量也使用内存存储;OPENCLAW_INSTANCE_ID 会改变命名空间,且不会迁移旧状态。
修复边界:认证相关文件为 src/server/auth/{admin-auth,admin-secret,session,vercel-auth,route-auth}.ts;存储相关为 src/server/store/{store,redis-store,memory-store,keyspace}.ts 与 src/shared/types.ts;路由只改受影响的路由处理器;文档与环境契约涉及 .env.example、README.md、CONTRIBUTING.md、CLAUDE.md。
验证命令:node scripts/verify.mjs --steps=test,typecheck;pnpm check:verify-contract;lat check。当环境变量、认证模式文档或操作说明发生变化时,需运行 pnpm check:verify-contract。
限制:资料未提供更详细的错误码、平台支持范围或收费信息,暂未提供。