Troubleshooting

Fix startup, provider, permission, and tool problems.

Most issues fall into install, provider, local runtime, or project configuration. Start with nextos --version, nextos providers, nextos models, and nextos mcp. If a task appears stuck, check the permission center. If files are missing, confirm the project root. If MCP fails, disable and re-enable the server or refresh auth. Report reproducible bugs at https://github.com/ningchun/NextOS/issues.