第一阶段里程碑回顾与变更合并

t101 第一阶段里程碑回顾与变更合并

第一阶段目标回顾

1. 完成 t101 租户基础运行能力恢复
   • user-service 与 gateway 稳定运行
   • 本地访问端口与健康检查通过
2. 完成企微通道接入可用
   • wecom 插件安装并启用
   • 通道配置为 configured, enabled
   • 网关与企微服务维持心跳
3. 完成模型调用链路可用
   • 修复 agent 认证缺失导致的启动前失败
   • 消除 Unknown model / 404 / provider 配置错配
   • 达成可实际返回对话结果

目标达成情况

• 目标1：已达成
• 目标2：已达成
• 目标3：已达成

里程碑判定：第一阶段完成

合并后的变更清单

1) 租户与网关编排

• 更新租户编排变量与网关启动参数，统一 loopback 与 token 鉴权
• 关键文件：
  • workspaces/tenants/t101/tenant.compose.yaml
  • templates/tenant/tenant.compose.template.yaml

2) 租户基础配置

• 补全 t101 环境变量与租户定义中的模型、企微、安全配置
• 关键文件：
  • workspaces/tenants/t101/tenant.env
  • workspaces/tenants/t101/tenant.yaml

3) OpenClaw 网关配置

• 完成 channels.wecom 配置补全（botId/secret/websocketUrl/policy）
• 固化 gateway 本地模式与认证配置
• 修正插件启用口径为 wecom-openclaw-plugin
• 完成模型配置切换为 NVIDIA 兼容接入：
  • provider: nvidia
  • model: z-ai/glm5
  • primary: nvidia/z-ai/glm5
• 关键文件：
  • workspaces/tenants/t101/openclaw/openclaw.json

4) Agent 认证配置

• 为 main agent 建立独立 auth store，修复 No API key found 类错误
• 关键文件：
  • workspaces/tenants/t101/openclaw/agents/main/agent/auth-profiles.json

5) 运维与文档资产

• 新增插件自动安装脚本
• 更新 README 的插件安装说明
• 形成联调验收文档并并入本合并文档
• 关键文件：
  • scripts/install-wecom-plugin.ps1
  • README.md
  • workspaces/tenants/t101/联调验收报告.md

验证结果摘要

服务可用性

• tenant-t101-user-service 与 tenant-t101-gateway 运行正常
• 健康检查通过：/healthz 返回 {"ok":true}
• 端口连通正常：28101 / 28701

企微链路

• 通道状态：企业微信 default = configured, enabled
• 心跳日志持续正常，连接稳定

模型链路

• 当前默认模型：nvidia/z-ai/glm5
• 本地 agent 调用可成功返回（测试消息返回 OK）
• 历史错误已收敛：No API key found、Unknown model、HTTP 404 未作为当前阻塞项

阶段输出与结论

• 第一阶段目标已完成，可进入第二阶段（真实业务消息压测与双租户一致性收口）
• 当前 t101 已具备：
  • 可运行
  • 可接入企微
  • 可调用模型并返回结果

第二阶段建议入口

1. 真实企微收发压测（单聊/群聊/并发）
2. t102 同步修复与一致性对齐
3. 统一沉淀 tenant 模板，避免后续租户重复手工修复