muse部署失败主因是认证、记忆加载、工具连接三类基础能力未就绪。需依次排查：mcp server连通性及auth.yaml配置；memory backend启动与session id透传；插件状态、权限及webhook一致性；以及tracing、prompt缓存和planner日志是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
部署失败不是 Muse 本身不可用，而是运行环境、配置或权限链路上某个环节没对齐。真正卡住的往往不是模型或代码，而是认证、记忆加载、工具连接这三类基础能力没就绪。下面按发生频率和影响程度，分四类典型问题给你说清楚怎么查、怎么修。
认证失败：调不通、注册不进、工具访问被拒
这是最常遇到的第一道坎。Muse 启动后提示“Failed to authenticate with MCP Server”或“Tool plugin registration timeout”，说明它连自己的调度中枢都没登录上。
- 先确认 MCP Server 是否已启动且可访问：执行
curl -X GET http://localhost:8080/health，返回{"status":"ok"}才算通；如果超时，检查端口是否被占用、防火墙是否拦截 - 核对 auth.yaml 配置是否完整：必须包含
client_id、client_secret、issuer_url三项，缺一不可；注意issuer_url末尾不能带斜杠（如http://mcp.local✅，http://mcp.local/❌） - 若用 WorkOS 或自建 Auth0，需额外在 Muse 的
connectors目录下启用对应 connector，并确保回调地址与后台注册一致（常见错在本地开发用http://localhost:3000/callback，但后台填了https://yourdomain.com/callback）
记忆模块异常：会话断连、长期记忆消失、上下文乱序
表现是：前一句还在聊订酒店，后一句突然问“你是谁”；或重启后所有历史偏好（如常用地址、支付方式）全丢。这不是模型忘了，是记忆流水线没挂载成功。
- 检查 memory backend 是否启动：Muse 默认依赖 TencentDB Agent Memory 或本地 LevelDB。运行
ps aux | grep tencentdb-agent-memory，没进程就手动启动服务，或改用内置file://./mem路径做临时验证 - 确认 session ID 是否跨请求透传：前端调用时必须携带
X-Session-ID请求头；Web UI 用户需检查 cookie 中muse_session是否有效且未过期（默认 7 天） - 排查 长期记忆 schema 不匹配：升级 Muse Spark 1.3 后，若复用旧版 memory 数据库，会出现字段缺失报错（如 missing field
last_active_at）。建议清空旧数据目录，或运行迁移脚本muse-migrate --from v1.2 --to v1.3
工具插件失联：能对话但无法执行、按钮灰掉、动作规划器卡住
比如你说“帮我查明天上海天气”，Muse 返回“正在调用天气服务……”，然后一直转圈；或者“打开京东”指令后无反应。问题不在大模型，而在插件没活过来。
- 运行
muse-cli list-plugins，看插件状态是否为active；若显示failed，重点看日志里plugin-init段落，90% 是路径错误或依赖缺失（例如 ChromeDriver 版本与系统 Chrome 不匹配） - Web 自动化类插件（如电商下单、政务填表）需确认 Accessibility API 权限已开启：Mac 上检查“系统设置 > 隐私与安全性 > 辅助功能”是否勾选 Muse；Windows 需开启“设置 > 蓝牙和其他设备 > 投影到此电脑”并允许辅助应用控制
- API 类插件（如飞书通知、钉钉审批）要验证 webhook token 和加密密钥是否与平台后台完全一致，大小写、空格、换行符都算差异
可观测性缺失：没报错但行为诡异、调试日志为空、tracing 断链
这类最难定位：任务看似跑完了，结果却不对；或者根本不知道它到底执行到哪一步就停了。本质是观测链路没打通，等于盲开。
- 强制启用 full tracing：启动时加参数
--log-level debug --enable-tracing，再看logs/tracing/下是否有 span 文件生成；没有说明 Langfuse 或 OpenTelemetry exporter 配置失效 - 检查 prompt 缓存是否被跳过：Spark 1.3 默认启用 prompt versioning，若
PROMPT_REPO_PATH环境变量未设，会回退到内存缓存，重启即丢——务必指向一个 Git 仓库或本地文件夹 - 验证 action planner 日志是否输出：搜索日志关键词
[planner]，正常应有 “decomposed into 3 sub-tasks”、“executing step 2/3” 等记录；若无，说明planner-engine模块未加载，可能因模型路由配置错误（如指定llama3-70b但实际只部署了qwen2-7b）
