日常操作
按部署模式选择对应轨道：
- 单机 Docker 部署见 单机 Docker 轨道。
- K8s 集群部署见 K8s 集群轨道。
- 两种模式共有的巡检项见 通用部分。
单机 Docker 轨道
脚本随离线包提供，位于
deploy/scripts/目录；需先cd到离线包的deploy目录再执行。
查看服务状态与日志
# 容器状态
./scripts/fleet.sh ps
# 跟踪某服务日志
./scripts/fleet.sh logs -f <service-name>
# 使用 watch-logs 实时查看（配合 LOG_FILES）
LOG_FILES=./fleet.log ./scripts/fleet.sh up -d
./scripts/watch-logs.sh -- ./fleet.log早期版本需在命令中指定版本参数（basic / advance）；该机制已退役：省略参数即启动默认栈，advance / enterprise 会直接报错退出，basic 兼容保留但会打印弃用警告（等效于省略）。
健康诊断
./scripts/doctor.sh # 关键服务
./scripts/doctor.sh --all # 全部服务
./scripts/doctor.sh --logs # 附带关键服务最近日志doctor.sh 检查项包含：API Gateway（26100）、Identity（26101）、Orchestrator（26102）、AG-UI（26103）、AI-Infra-RS（26450）的 /health，PostgreSQL（26110）、TimescaleDB（26111）、NATS（26112）的端口连通性，以及 503 路径诊断与 IM 渠道绑定配置。
启停与重启
./scripts/fleet.sh up -d
./scripts/fleet.sh down
./scripts/fleet.sh restart <service-name>down 默认会停止租户 claw 容器；如需保留租户 claw（仅停平台），加 --keep-tenant-claws。up -d 默认会触发租户 claw reconcile；如需跳过，加 --no-reconcile。
配置热更新边界
| 操作 | 是否需要 down + up |
|---|---|
| 管理后台修改 LLM 模型配置 | 否（约 30 秒内生效） |
修改 ADMIN_EMAILS | 是 |
修改 deploy/config/*.yaml | 重启对应服务 |
修改 docker-compose.override.yml | 是 |
LLM 模型配置在管理后台维护（持久化在数据库），修改后经内部配置接口下发、约 30 秒内生效，无需重启；.env 的 LLM_* 仅作首次启动引导。deploy/config/*.yaml 是 ai-infra-rs 的运行时配置，热加载边界见 运维配置。
K8s 集群轨道
查看服务状态与日志
# Pod 状态
kubectl -n <ns> get pods -o wide
kubectl -n <ns> get deploy -o wide
# 跟踪日志
kubectl -n <ns> logs -f <pod> -c <container>
kubectl -n <ns> logs -l app=<svc> --tail=200
# 事件
kubectl -n <ns> get events --sort-by=.lastTimestamp完整 K8s 命令清单见 服务健康检查。
健康诊断
./scripts/verify-k8s-install.sh
kubectl -n <ns> get pods
kubectl -n <ns> get events --sort-by=.lastTimestampverify-k8s-install.sh 需指定 --gateway http://<node-ip>:30001。该脚本依次校验：集群访问、平台 Pod 状态、PVC 绑定、claw-fleet-manager /health、租户 claw（Profile B）、Restate admin、网关 HTTP 冒烟，可选 --e2e 跑注册/登录/Agent SSE。
启停与扩缩
# 扩缩容
kubectl -n <ns> scale deploy/<svc> --replicas=<N>
# 滚动重启
kubectl -n <ns> rollout restart deploy/<svc>
# Helm 升级
helm upgrade <release> <chart> -n <ns> -f values.yamlclaw 实例管理
./scripts/reconcile-claw-deployments.sh
./scripts/reconcile-claw-deployments.sh --forcereconcile-claw-deployments.sh 用于离线升级或 fleet 重启后修正租户 claw 的 ai_infra_base_url 失效：选择性重启 primary 部署，再触发 identity-service 同步 claw-fleet-manager 注册表。--force 重启所有 primary 部署，建议离线升级后使用。
配置更新
ConfigMap / Secret 改完触发 Pod 重建：
kubectl -n <ns> rollout restart deploy/<svc>Helm values 改完用 helm upgrade，Helm 会自动触发滚动更新；若仅改 Secret/ConfigMap 而未触发模板差异，需手动 rollout restart。
通用部分
渠道连通性巡检
各发一条测试消息到飞书/企业微信/钉钉机器人，确认 connector 收到并投递。doctor.sh 的 "IM Channel Bind Config" 段会检查 identity /internal/config/{feishu,dingtalk,wecom} 的 bind_base_url 与 bind_state_secret 是否完整（需 .env 中设置 INTERNAL_SERVICE_TOKEN）。
LLM 配额监控
AI_INFRA_RS_RPM_PER_USER 触顶时，考虑：
- 提高单用户 RPM 配额（
.env或deploy/config/ai-infra.yaml）。 - 排查是否有循环调用（看 ai-infra-rs 日志的
event=llm.call频次）。 - 联系 LLM 提供商提升上游配额。
contract 版本握手
curl http://<host>:26450/health | jq .contract_version非 unknown 即可。详见 服务健康检查。